Bagikan melalui

Set-AzSqlServerActiveDirectoryAdministrator

Modul:
Az.Sql Module

Menyediakan administrator Microsoft Entra untuk SQL Server.

Sintaks

Default (Default) 

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. Server 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 konfirmasi sebelum menjalankan cmdlet.

Properti parameter

Jenis:SwitchParameter
Nilai default:False
Mendukung wildcard:False
DontShow:False
Alias:Cf

Kumpulan parameter

(All)
Position:Named
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa:False

-DefaultProfile

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

Properti parameter

Jenis:IAzureContextContainer
Nilai default:None
Mendukung wildcard:False
DontShow:False
Alias:AzContext, AzureRmContext, AzureCredential

Kumpulan parameter

(All)
Position:Named
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa:False

-DisplayName

Menentukan nama tampilan administrator Microsoft Entra yang disediakan cmdlet ini.

Properti parameter

Jenis:String
Nilai default:None
Mendukung wildcard:False
DontShow:False

Kumpulan parameter

(All)
Position:2
Wajib:True
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:True
Nilai dari argumen yang tersisa:False

-ObjectId

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

Properti parameter

Jenis:Guid
Nilai default:None
Mendukung wildcard:False
DontShow:False

Kumpulan parameter

(All)
Position:3
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:True
Nilai dari argumen yang tersisa:False

-ResourceGroupName

Menentukan nama grup sumber daya tempat server ditetapkan.

Properti parameter

Jenis:String
Nilai default:None
Mendukung wildcard:False
DontShow:False

Kumpulan parameter

(All)
Position:0
Wajib:True
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:True
Nilai dari argumen yang tersisa:False

-ServerName

Menentukan nama SQL Server tempat cmdlet ini menyediakan administrator.

Properti parameter

Jenis:String
Nilai default:None
Mendukung wildcard:False
DontShow:False

Kumpulan parameter

(All)
Position:1
Wajib:True
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:True
Nilai dari argumen yang tersisa:False

-WhatIf

Menunjukkan apa yang akan terjadi ketika cmdlet dijalankan. Cmdlet tidak dijalankan.

Properti parameter

Jenis:SwitchParameter
Nilai default:False
Mendukung wildcard:False
DontShow:False
Alias:wi

Kumpulan parameter

(All)
Position:Named
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa:False

CommonParameters

Cmdlet ini mendukung parameter umum: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, dan -WarningVariable. Untuk informasi selengkapnya, lihat about_CommonParameters.

Input

String

Guid

Output

AzureSqlServerActiveDirectoryAdministratorModel