Megosztás:

Set-AzSqlServerActiveDirectoryAdministrator

Modul:
Az.Sql Module

Kiépít egy Microsoft Entra-rendszergazdát az SQL Serverhez.

Szintaxis

Default (Alapértelmezett) 

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

Leírás

A Set-AzSqlServerActiveDirectoryAdministrator parancsmag kiépít egy Microsoft Entra-rendszergazdát az AzureSQL Serverhez az aktuális előfizetésben. Egyszerre csak egy rendszergazdát építhet ki. A Microsoft Entra ID következő tagjai SQL Server-rendszergazdaként építhetők ki:

  • A Microsoft Entra ID natív tagjai
  • A Microsoft Entra ID összevont tagjai
  • Importált tagok más Azure AD-ből, akik natív vagy összevont tagok
  • A Microsoft Entra biztonsági csoportokként létrehozott Microsoft-fiókokat, például a Outlook.com, Hotmail.com vagy Live.com tartományokat nem támogatják rendszergazdaként. Más vendégfiókok, például a Gmail.com vagy Yahoo.com tartományokban lévő fiókok nem támogatottak rendszergazdaként. Javasoljuk, hogy rendszergazdaként kiépítsen egy dedikált Microsoft Entra-csoportot.

Példák

1. példa: Rendszergazdai csoport kiépítése kiszolgálóhoz

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

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

Ez a parancs kiépít egy DbAs nevű Microsoft Entra rendszergazdai csoportot a Server01 nevű kiszolgálóhoz. Ez a kiszolgáló a ResourceGroup01 erőforráscsoporthoz van társítva.

2. példa: Rendszergazdai felhasználó kiépítése kiszolgálóhoz

Set-AzSqlServerActiveDirectoryAdministrator -ResourceGroupName "ResourceGroup01" -ServerName "Server01" -DisplayName "David Chew"

ResourceGroupName ServerName DisplayName ObjectId IsAzureADOnlyAuthentication
----------------- ---------- ----------- --------
resourcegroup01   server01   David Chew  11E95548-B179-4FE1-9AF4-ACA49D13ABB9 False

Ez a parancs a Server01 nevű kiszolgáló rendszergazdájaként egy Microsoft Entra-felhasználót helyez üzembe.

3. példa: Rendszergazdai csoport kiépítése az azonosító megadásával

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

Ez a parancs kiépít egy DbAs nevű Microsoft Entra rendszergazdai csoportot a Server01 nevű kiszolgálóhoz. A parancs megadja az ObjectId paraméter azonosítóját. Így a parancs akkor is sikeres lesz, ha a csoport megjelenítendő neve nem egyedi.

Paraméterek

-Confirm

Megerősítést kér a parancsmag futtatása előtt.

Paramétertulajdonságok

Típus:SwitchParameter
Alapértelmezett érték:False
Támogató vadkártyák:False
Don't Show:False
Aliasok:Cf

Paraméterhalmazok

(All)
Pozíció:Named
Kötelező:False
Érték a csővezetékből:False
Érték a csővezetékből az ingatlan név szerint:False
Érték a maradék argumentumokból:False

-DefaultProfile

Az Azure-ral való kommunikációhoz használt hitelesítő adatok, fiók, bérlő és előfizetés

Paramétertulajdonságok

Típus:IAzureContextContainer
Alapértelmezett érték:None
Támogató vadkártyák:False
Don't Show:False
Aliasok:AzContext, AzureRmContext, AzureCredential

Paraméterhalmazok

(All)
Pozíció:Named
Kötelező:False
Érték a csővezetékből:False
Érték a csővezetékből az ingatlan név szerint:False
Érték a maradék argumentumokból:False

-DisplayName

Megadja annak a Microsoft Entra-rendszergazdának a megjelenítendő nevét, amelyet a parancsmag kiépít.

Paramétertulajdonságok

Típus:String
Alapértelmezett érték:None
Támogató vadkártyák:False
Don't Show:False

Paraméterhalmazok

(All)
Pozíció:2
Kötelező:True
Érték a csővezetékből:False
Érték a csővezetékből az ingatlan név szerint:True
Érték a maradék argumentumokból:False

-ObjectId

Megadja annak a Microsoft Entra-rendszergazdának az egyedi azonosítóját, amelyet a parancsmag kiépít. Ha a megjelenítendő név nem egyedi, meg kell adnia egy értéket ehhez a paraméterhez.

Paramétertulajdonságok

Típus:Guid
Alapértelmezett érték:None
Támogató vadkártyák:False
Don't Show:False

Paraméterhalmazok

(All)
Pozíció:3
Kötelező:False
Érték a csővezetékből:False
Érték a csővezetékből az ingatlan név szerint:True
Érték a maradék argumentumokból:False

-ResourceGroupName

Annak az erőforráscsoportnak a nevét adja meg, amelyhez a kiszolgáló hozzá van rendelve.

Paramétertulajdonságok

Típus:String
Alapértelmezett érték:None
Támogató vadkártyák:False
Don't Show:False

Paraméterhalmazok

(All)
Pozíció:0
Kötelező:True
Érték a csővezetékből:False
Érték a csővezetékből az ingatlan név szerint:True
Érték a maradék argumentumokból:False

-ServerName

Annak az SQL Servernek a nevét adja meg, amelyhez ez a parancsmag rendszergazdai jogosultságot biztosít.

Paramétertulajdonságok

Típus:String
Alapértelmezett érték:None
Támogató vadkártyák:False
Don't Show:False

Paraméterhalmazok

(All)
Pozíció:1
Kötelező:True
Érték a csővezetékből:False
Érték a csővezetékből az ingatlan név szerint:True
Érték a maradék argumentumokból:False

-WhatIf

Megjeleníti, mi történne, ha a parancsmag futna. A parancsmag nem fut.

Paramétertulajdonságok

Típus:SwitchParameter
Alapértelmezett érték:False
Támogató vadkártyák:False
Don't Show:False
Aliasok:Wi

Paraméterhalmazok

(All)
Pozíció:Named
Kötelező:False
Érték a csővezetékből:False
Érték a csővezetékből az ingatlan név szerint:False
Érték a maradék argumentumokból:False

CommonParameters

Ez a parancsmag a következő gyakori paramétereket támogatja: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction és -WarningVariable. További információért lásd about_CommonParameters.

Bemenetek

String

Guid

Kimenetek

AzureSqlServerActiveDirectoryAdministratorModel