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 Standard. Andere Gastkonten wie die in der Gmail.com oder Yahoo.com tun Standard 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.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

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

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DisplayName

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

Type:String
Position:2
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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.

Type:Guid
Position:3
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ResourceGroupName

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

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ServerName

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

Type:String
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Eingaben

String

Guid

Ausgaben

AzureSqlServerActiveDirectoryAdministratorModel