Set-AzSqlServerActiveDirectoryAdministrator

Menyediakan administrator Microsoft Entra untuk SQL Server.

Sintaks

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

Deskripsi

Cmdlet Set-AzSqlServerActiveDirectoryAdministrator menyediakan administrator Microsoft Entra untuk AzureSQL Server dalam langganan saat ini. Anda hanya dapat menyediakan satu administrator pada satu waktu. Anggota ID Microsoft Entra berikut dapat disediakan sebagai administrator SQL Server:

  • Anggota asli ID Microsoft Entra
  • Anggota federasi ID Microsoft Entra
  • Anggota yang diimpor dari Azure AD lain yang merupakan anggota asli atau terfederasi
  • Grup Microsoft Entra yang dibuat sebagai grup keamanan akun Microsoft, seperti yang ada di domain Outlook.com, Hotmail.com, atau Live.com, tidak didukung sebagai administrator. Akun tamu lain, seperti yang ada di domain Gmail.com atau Yahoo.com, tidak didukung sebagai administrator. Kami menyarankan agar Anda menyediakan grup Microsoft Entra khusus sebagai administrator.

Contoh

Contoh 1: Menyediakan grup administrator untuk server

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

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

Perintah ini menyediakan grup administrator Microsoft Entra bernama DBA untuk server bernama Server01. Peladen ini dikaitkan dengan grup sumber daya ResourceGroup01.

Contoh 2: Memprovisikan pengguna administrator untuk 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

Perintah ini menyediakan pengguna Microsoft Entra sebagai administrator untuk server bernama Server01.

Contoh 3: Memprovisikan grup administrator dengan menentukan ID-nya

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

Perintah ini menyediakan grup administrator Microsoft Entra bernama DBA untuk server bernama Server01. Perintah menentukan ID untuk parameter ObjectId . Ini memastikan bahwa perintah berhasil meskipun nama tampilan grup tidak unik.

Parameter

-Confirm

Meminta Anda mengonfirmasi sebelum menjalankan cmdlet.

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

-DefaultProfile

Kredensial, akun, penyewa, dan langganan yang digunakan untuk komunikasi dengan azure

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

-DisplayName

Menentukan nama tampilan administrator Microsoft Entra yang disediakan cmdlet ini.

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

-ObjectId

Menentukan ID unik administrator Microsoft Entra yang disediakan cmdlet ini. Jika nama tampilan tidak unik, Anda harus menentukan nilai untuk parameter ini.

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

-ResourceGroupName

Menentukan nama grup sumber daya tempat server ditetapkan.

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

-ServerName

Menentukan nama SQL Server tempat cmdlet ini menyediakan administrator.

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

-WhatIf

Menunjukkan apa yang akan terjadi jika cmdlet berjalan. Cmdlet tidak dijalankan.

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

Input

String

Guid

Output

AzureSqlServerActiveDirectoryAdministratorModel