Freigeben über

Set-AzSqlServerActiveDirectoryAdministrator

Modul:
Az.Sql Module

Stellt einen Microsoft Entra Administrator für SQL Server fest.

Syntax

Default (Standard) 

Set-AzSqlServerActiveDirectoryAdministrator
    [-DisplayName] <String>
    [[-ObjectId] <Guid>]
    [-ServerName] <String>
    [-ResourceGroupName] <String>
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Beschreibung

Das Cmdlet Set-AzSqlServerActiveDirectoryAdministrator stellt einen Microsoft Entra Administrator für AzureSQL Server im aktuellen Abonnement bereit. Sie können jeweils nur einen Administrator bereitstellen. Die folgenden Mitglieder von Microsoft Entra ID können als SQL Server-Administrator bereitgestellt werden:

  • Native Mitglieder von Microsoft Entra ID
  • Partnermitglieder von Microsoft Entra ID
  • Importierte Mitglieder aus anderen Azure ADs, die systemeigene oder Verbundmitglieder sind
  • Microsoft Entra Gruppen, die als Sicherheitsgruppen Microsoft Konten erstellt wurden, z. B. Outlook.com, Hotmail.com oder Live.com Domänen, werden nicht als Administratoren unterstützt. Andere Gastkonten, z. B. die in der Gmail.com oder Yahoo.com Domänen, werden nicht als Administratoren unterstützt. Es wird empfohlen, eine dedizierte Microsoft Entra Gruppe als Administrator bereitzustellen.

Beispiele

Beispiel 1: Bereitstellen einer Administratorgruppe für einen Server

Set-AzSqlServerActiveDirectoryAdministrator -ResourceGroupName "ResourceGroup01" -ServerName "Server01" -DisplayName "DBAs"

ResourceGroupName ServerName DisplayName ObjectId IsAzureADOnlyAuthentication
----------------- ---------- ----------- -------- ---------------------------
ResourceGroup01   Server01   DBAs        40b79501-b343-44ed-9ce7-da4c8cc7353b False

Mit diesem Befehl wird eine Microsoft Entra Administratorgruppe namens DBAs für den Server mit dem Namen Server01 angegeben. Dieser Server ist der Ressourcengruppe ResourceGroup01 zugeordnet.

Beispiel 2: Bereitstellen eines Administratorbenutzers für einen Server

Set-AzSqlServerActiveDirectoryAdministrator -ResourceGroupName "ResourceGroup01" -ServerName "Server01" -DisplayName "David Chew"

ResourceGroupName ServerName DisplayName ObjectId IsAzureADOnlyAuthentication
----------------- ---------- ----------- --------
resourcegroup01   server01   David Chew  11E95548-B179-4FE1-9AF4-ACA49D13ABB9 False

Mit diesem Befehl wird ein Microsoft Entra Benutzer als Administrator für den Server mit dem Namen Server01 bereitgestellt.

Beispiel 3: Bereitstellen einer Administratorgruppe durch Angeben der ID

Set-AzSqlServerActiveDirectoryAdministrator -ResourceGroupName "ResourceGroup01" -ServerName "Server01" -DisplayName "DBAs" -ObjectId "40b79501-b343-44ed-9ce7-da4c8cc7353b"

ResourceGroupName ServerName DisplayName ObjectId IsAzureADOnlyAuthentication
----------------- ---------- ----------- --------
ResourceGroup01   Server01   DBAs        40b79501-b343-44ed-9ce7-da4c8cc7353b False

Mit diesem Befehl wird eine Microsoft Entra Administratorgruppe namens DBAs für den Server mit dem Namen Server01 angegeben. Der Befehl gibt eine ID für den Parameter ObjectId an. Dadurch wird sichergestellt, dass der Befehl erfolgreich ist, auch wenn der Anzeigename der Gruppe nicht eindeutig ist.

Parameter

-Confirm

Fordert Sie zur Bestätigung auf, bevor Sie das Cmdlet ausführen.

Parametereigenschaften

Typ:SwitchParameter
Standardwert:False
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:Cf

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-DefaultProfile

Anmeldeinformationen, Konto, Mandant und Abonnement für die Kommunikation mit Azure

Parametereigenschaften

Typ:IAzureContextContainer
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:AzContext, AzureRmContext, AzureCredential

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-DisplayName

Gibt den Anzeigenamen des Microsoft Entra Administrators an, den dieses Cmdlet festlegt.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:2
Obligatorisch:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-ObjectId

Gibt die eindeutige ID des Microsoft Entra Administrators an, den dieses Cmdlet festlegt. Wenn der Anzeigename nicht eindeutig ist, müssen Sie einen Wert für diesen Parameter angeben.

Parametereigenschaften

Typ:Guid
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:3
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-ResourceGroupName

Gibt den Namen der Ressourcengruppe an, der der Server zugewiesen ist.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:0
Obligatorisch:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-ServerName

Gibt den Namen der SQL Server an, für die dieses Cmdlet einen Administrator bereitstellen kann.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:1
Obligatorisch:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-WhatIf

Zeigt, was passiert, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Parametereigenschaften

Typ:SwitchParameter
Standardwert:False
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:Wi

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

CommonParameters

Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.

Eingaben

String

Guid

Ausgaben

AzureSqlServerActiveDirectoryAdministratorModel