Delen via


Set-AzSqlServerActiveDirectoryAdministrator

Richt een Microsoft Entra-beheerder in voor SQL Server.

Syntaxis

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

Description

Met de cmdlet Set-AzSqlServerActiveDirectoryAdministrator wordt een Microsoft Entra-beheerder ingericht voor AzureSQL Server in het huidige abonnement. U kunt slechts één beheerder tegelijk inrichten. De volgende leden van Microsoft Entra-id kunnen worden ingericht als SQL Server-beheerder:

  • Systeemeigen leden van Microsoft Entra-id
  • Federatieve leden van Microsoft Entra-id
  • Geïmporteerde leden van andere Azure-AD's die systeemeigen of federatieve leden zijn
  • Microsoft Entra-groepen die zijn gemaakt als beveiligingsgroepen microsoft-accounts, zoals die in de Outlook.com, Hotmail.com of Live.com domeinen, worden niet ondersteund als beheerders. Andere gastaccounts, zoals die in de Gmail.com- of Yahoo.com-domeinen, worden niet ondersteund als beheerders. U wordt aangeraden een speciale Microsoft Entra-groep in te richten als beheerder.

Voorbeelden

Voorbeeld 1: Een beheerdersgroep inrichten voor een server

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

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

Met deze opdracht wordt een Microsoft Entra-beheerdersgroep met de naam DBA's voor de server met de naam Server01 ingesteld. Deze server is gekoppeld aan resourcegroep ResourceGroup01.

Voorbeeld 2: Een beheerdergebruiker inrichten voor een 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

Met deze opdracht richt u een Microsoft Entra-gebruiker in als beheerder voor de server met de naam Server01.

Voorbeeld 3: Een beheerdersgroep inrichten door de id op te geven

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

Met deze opdracht wordt een Microsoft Entra-beheerdersgroep met de naam DBA's voor de server met de naam Server01 ingesteld. Met de opdracht geeft u een id op voor de parameter ObjectId . Dit zorgt ervoor dat de opdracht slaagt, zelfs als de weergavenaam van de groep niet uniek is.

Parameters

-Confirm

Hiermee wordt u gevraagd om bevestiging voordat u de cmdlet uitvoert.

Type:SwitchParameter
Aliassen:cf
Position:Named
Default value:False
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-DefaultProfile

De referenties, het account, de tenant en het abonnement dat wordt gebruikt voor communicatie met Azure

Type:IAzureContextContainer
Aliassen:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-DisplayName

Hiermee geeft u de weergavenaam op van de Microsoft Entra-beheerder die met deze cmdlet wordt ingesteld.

Type:String
Position:2
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-ObjectId

Hiermee geeft u de unieke id op van de Microsoft Entra-beheerder die met deze cmdlet wordt geconfigureerd. Als de weergavenaam niet uniek is, moet u een waarde voor deze parameter opgeven.

Type:Guid
Position:3
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-ResourceGroupName

Hiermee geeft u de naam op van de resourcegroep waaraan de server is toegewezen.

Type:String
Position:0
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-ServerName

Hiermee geeft u de naam op van de SQL Server waarvoor deze cmdlet een beheerder in richt.

Type:String
Position:1
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-WhatIf

Hiermee wordt weergegeven wat er zou gebeuren als u de cmdlet uitvoert. De cmdlet wordt niet uitgevoerd.

Type:SwitchParameter
Aliassen:wi
Position:Named
Default value:False
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

Invoerwaarden

String

Guid

Uitvoerwaarden

AzureSqlServerActiveDirectoryAdministratorModel