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, 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 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