Aracılığıyla paylaş


Set-AzSqlInstanceActiveDirectoryAdministrator

SQL Yönetilen Örneği için bir Microsoft Entra yöneticisi sağlar.

Sözdizimi

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

Description

Set-AzSqlInstanceActiveDirectoryAdministrator cmdlet'i geçerli abonelikte Azure SQL Yönetilen Örneği için bir Microsoft Entra yöneticisi sağlar. Aynı anda yalnızca bir yönetici sağlayabilirsiniz. Microsoft Entra Id'nin aşağıdaki üyeleri SQL Yönetilen Örneği yöneticisi olarak sağlanabilir:

  • Microsoft Entra Id'nin yerel üyeleri
  • Microsoft Entra Id'nin federasyon üyeleri
  • Güvenlik grupları olarak oluşturulan Microsoft Entra grupları Diğer Azure KIMLIKlerinden içeri aktarılan üyeler yönetici olarak desteklenmez. Outlook.com, Hotmail.com veya Live.com etki alanlarındakiler gibi Microsoft hesapları yönetici olarak desteklenmez. Gmail.com veya Yahoo.com etki alanlarındakiler gibi diğer konuk hesapları yönetici olarak desteklenmez. Yönetici olarak ayrılmış bir Microsoft Entra grubu sağlamanızı öneririz.

Örnekler

Örnek 1: Kaynak grubuyla ilişkilendirilmiş yönetilen örnek için yönetici grubu sağlama

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

Bu komut, ManagedInstance01 adlı yönetilen örnek için DBAs adlı bir Microsoft Entra yönetici grubu sağlar. Bu sunucu ResourceGroup01 kaynak grubuyla ilişkilendirildi.

Örnek 2: Yönetilen örnek nesnesini kullanarak yönetici kullanıcı sağlama

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

Bu komut, yönetilen örnek nesnesinden bir Microsoft Entra kullanıcısını yönetici olarak sağlar.

Örnek 3: Yönetilen örnek kaynak tanımlayıcısı kullanarak yönetici sağlama

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

Bu komut, yönetilen örnek kaynak tanımlayıcısı kullanarak bir Microsoft Entra kullanıcılarını yönetici olarak sağlar.

Parametreler

-Confirm

Cmdlet'i çalıştırmadan önce sizden onay ister.

Tür:SwitchParameter
Diğer adlar:cf
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-DefaultProfile

Azure ile iletişim için kullanılan kimlik bilgileri, hesap, kiracı ve abonelik.

Tür:IAzureContextContainer
Diğer adlar:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-DisplayName

İzinlerin verleneceği kullanıcının veya grubun görünen adını belirtir. Bu görünen ad, geçerli abonelikle ilişkilendirilmiş active directory'de bulunmalıdır.

Tür:String
Position:2
Default value:None
Gerekli:True
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

-InputObject

Kullanılacak yönetilen örnek nesnesi.

Tür:AzureSqlManagedInstanceModel
Position:Named
Default value:None
Gerekli:True
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

-InstanceName

SQL Yönetilen Örneği adı.

Tür:String
Position:1
Default value:None
Gerekli:True
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

-ObjectId

Microsoft Entra Id'de izinlerin verildiği kullanıcı veya grubun nesne kimliğini belirtir.

Tür:Guid
Position:3
Default value:None
Gerekli:True
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

-ResourceGroupName

Kaynak grubunun adı.

Tür:String
Position:0
Default value:None
Gerekli:True
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

-ResourceId

Kullanılacak örneğin kaynak kimliği

Tür:String
Position:0
Default value:None
Gerekli:True
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

-WhatIf

Cmdlet çalıştırılıyorsa ne olacağını gösterir. Cmdlet çalıştırılmaz.

Tür:SwitchParameter
Diğer adlar:wi
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

Girişler

String

Guid

Çıkışlar

AzureSqlInstanceActiveDirectoryAdministratorModel