Freigeben über

Set-AzSqlServerActiveDirectoryAdministrator

  • Referenz
Modul:
Az.Sql

Stellt einen Microsoft Entra-Administrator für SQL Server bereit.

Syntax

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 der Microsoft Entra-ID können als SQL Server-Administrator bereitgestellt werden:

  • Native Mitglieder der Microsoft Entra-ID
  • Partnermitglieder der Microsoft Entra-ID
  • Importierte Mitglieder aus anderen Azure-ADs, die systemeigene oder Verbundmitglieder sind
  • Microsoft Entra-Gruppen, die als Sicherheitsgruppen erstellt wurden, werden nicht als Administratoren unterstützt, z. B. in den Outlook.com-, Hotmail.com- oder Live.com-Domänen. 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

Dieser Befehl stellt eine Microsoft Entra-Administratorgruppe namens DBAs für den Server mit dem Namen Server01 bereit. 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

Dieser Befehl stellt einen Microsoft Entra-Benutzer als Administrator für den Server namens Server01 bereit.

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

Dieser Befehl stellt eine Microsoft Entra-Administratorgruppe namens DBAs für den Server mit dem Namen Server01 bereit. 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

Hiermit werden Sie vor der Ausführung des Cmdlets zur Bestätigung aufgefordert.

Typ:SwitchParameter
Aliase:cf
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DefaultProfile

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

Typ:IAzureContextContainer
Aliase:AzContext, AzureRmContext, AzureCredential
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DisplayName

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

Typ:String
Position:2
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-ObjectId

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

Typ:Guid
Position:3
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-ResourceGroupName

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

Typ:String
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-ServerName

Gibt den Namen des SQL Server an, für den dieses Cmdlet einen Administrator darstellt.

Typ:String
Position:1
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-WhatIf

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

Typ:SwitchParameter
Aliase:wi
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Eingaben

String

Guid

Ausgaben

AzureSqlServerActiveDirectoryAdministratorModel