Bagikan melalui

Set-AzSqlInstanceActiveDirectoryAdministrator

  • Referensi
Modul:
Az.Sql

Menyediakan administrator Microsoft Entra untuk SQL Managed Instance.

Sintaks

Set-AzSqlInstanceActiveDirectoryAdministrator
   [-DisplayName] <String>
   [-ObjectId] <Guid>
   [-ResourceGroupName] <String>
   [-InstanceName] <String>
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-AzSqlInstanceActiveDirectoryAdministrator
   [-DisplayName] <String>
   [-ObjectId] <Guid>
   -InputObject <AzureSqlManagedInstanceModel>
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-AzSqlInstanceActiveDirectoryAdministrator
   [-DisplayName] <String>
   [-ObjectId] <Guid>
   [-ResourceId] <String>
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Deskripsi

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

  • Anggota asli ID Microsoft Entra
  • Anggota federasi ID Microsoft Entra
  • Grup Microsoft Entra yang dibuat sebagai grup keamanan Anggota yang diimpor dari Azure AD lain tidak didukung sebagai administrator. 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 instans terkelola yang terkait dengan grup sumber daya

Set-AzSqlInstanceActiveDirectoryAdministrator -ResourceGroupName "ResourceGroup01" -InstanceName "ManagedInstance01" -DisplayName "DBAs" -ObjectId "40b79501-b343-44ed-9ce7-da4c8cc7353b"

ResourceGroupName InstanceName      DisplayName ObjectId 
----------------- ----------------- ----------- -------- 
ResourceGroup01   ManagedInstance01 DBAs        40b79501-b343-44ed-9ce7-da4c8cc7353b

Perintah ini menyediakan grup administrator Microsoft Entra bernama DBA untuk instans terkelola bernama ManagedInstance01. Peladen ini dikaitkan dengan grup sumber daya ResourceGroup01.

Contoh 2: Memprovisikan pengguna administrator menggunakan objek instans terkelola

Get-AzSqlInstance -ResourceGroupName "ResourceGroup01" -InstanceName "ManagedInstance01" | Set-AzSqlInstanceActiveDirectoryAdministrator -DisplayName "David Chew" -ObjectId "11E95548-B179-4FE1-9AF4-ACA49D13ABB9"

ResourceGroupName InstanceName      DisplayName ObjectId 
----------------- ----------------- ----------- -------- 
Resourcegroup01   ManagedInstance01 David Chew  11E95548-B179-4FE1-9AF4-ACA49D13ABB9

Perintah ini menyediakan pengguna Microsoft Entra sebagai administrator dari objek instans terkelola.

Contoh 3: Memprovisikan administrator menggunakan pengidentifikasi sumber daya instans terkelola

Get-AzSqlInstance -ResourceId "/subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/ResourceGroup01/providers/Microsoft.Sql/managedInstances/ManagedInstance01" | Set-AzSqlInstanceActiveDirectoryAdministrator -DisplayName "David Chew" -ObjectId "11E95548-B179-4FE1-9AF4-ACA49D13ABB9"

ResourceGroupName InstanceName      DisplayName ObjectId 
----------------- ----------------- ----------- -------- 
Resourcegroup01   ManagedInstance01 David Chew  11E95548-B179-4FE1-9AF4-ACA49D13ABB9

Perintah ini menyediakan pengguna Microsoft Entra sebagai administrator menggunakan pengidentifikasi sumber daya instans terkelola.

Parameter

-Confirm

Meminta Anda mengonfirmasi sebelum menjalankan cmdlet.

Jenis:SwitchParameter
Alias:cf
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-DefaultProfile

Kredensial, akun, penyewa, dan langganan yang digunakan untuk komunikasi dengan Azure.

Jenis:IAzureContextContainer
Alias:AzContext, AzureRmContext, AzureCredential
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-DisplayName

Menentukan nama tampilan pengguna atau grup yang akan diberikan izin. Nama tampilan ini harus ada di direktori aktif yang terkait dengan langganan saat ini.

Jenis:String
Position:2
Nilai default:None
Diperlukan:True
Terima input alur:True
Terima karakter wildcard:False

-InputObject

Objek instans terkelola untuk digunakan.

Jenis:AzureSqlManagedInstanceModel
Position:Named
Nilai default:None
Diperlukan:True
Terima input alur:True
Terima karakter wildcard:False

-InstanceName

Nama SQL Managed Instance.

Jenis:String
Position:1
Nilai default:None
Diperlukan:True
Terima input alur:True
Terima karakter wildcard:False

-ObjectId

Menentukan ID objek pengguna atau grup di ID Microsoft Entra untuk memberikan izin.

Jenis:Guid
Position:3
Nilai default:None
Diperlukan:True
Terima input alur:True
Terima karakter wildcard:False

-ResourceGroupName

Nama grup sumber daya.

Jenis:String
Position:0
Nilai default:None
Diperlukan:True
Terima input alur:True
Terima karakter wildcard:False

-ResourceId

Id sumber daya instans yang akan digunakan

Jenis:String
Position:0
Nilai default:None
Diperlukan:True
Terima input alur:True
Terima karakter wildcard:False

-WhatIf

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

Jenis:SwitchParameter
Alias:wi
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

Input

String

Guid

Output

AzureSqlInstanceActiveDirectoryAdministratorModel