Delen via

Set-AzSqlServerActiveDirectoryAdministrator

Module:
Az.Sql Module

Richt een Microsoft Entra beheerder in voor SQL Server.

Syntax

Default (Standaard) 

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

Description

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

  • Systeemeigen leden van Microsoft Entra ID
  • Federatieve leden van Microsoft Entra ID
  • Geïmporteerde leden van andere Azure-id's die systeemeigen of federatieve leden zijn
  • Microsoft Entra groepen die zijn gemaakt als beveiligingsgroepen Microsoft accounts, zoals groepen 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 toegewezen 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 administratorgroep 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 administratorgroep 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

Voordat u de cmdlet uitvoert, vraagt het systeem om bevestiging.

Parametereigenschappen

Type:SwitchParameter
Default value:False
Ondersteunt jokertekens:False
DontShow:False
Aliassen:Cf

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-DefaultProfile

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

Parametereigenschappen

Type:IAzureContextContainer
Default value:None
Ondersteunt jokertekens:False
DontShow:False
Aliassen:AzContext, AzureRmContext, AzureCredential

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-DisplayName

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

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:2
Verplicht:True
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten: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.

Parametereigenschappen

Type:Guid
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:3
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-ResourceGroupName

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

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:0
Verplicht:True
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-ServerName

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

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:1
Verplicht:True
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-WhatIf

Toont wat er zou gebeuren wanneer de cmdlet wordt uitgevoerd. De cmdlet wordt niet uitgevoerd.

Parametereigenschappen

Type:SwitchParameter
Default value:False
Ondersteunt jokertekens:False
DontShow:False
Aliassen:Wi

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

CommonParameters

Deze cmdlet ondersteunt de algemene parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction en -WarningVariable. Zie about_CommonParametersvoor meer informatie.

Invoerwaarden

String

Guid

Uitvoerwaarden

AzureSqlServerActiveDirectoryAdministratorModel