Set-AzSqlInstanceActiveDirectoryAdministrator

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

Syntax

UseResourceGroupAndInstanceNameParameterSet (Varsayılan)

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

UseInputObjectParameterSet

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

UserResourceIdParameterSet

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

Description

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

  • Microsoft Entra ID yerel üyeleri
  • Microsoft Entra ID federasyon üyeleri
  • Güvenlik grubu olarak oluşturulan Microsoft Entra grupları Diğer Azure AD'lerden içeri aktarılan üyeler yönetici olarak desteklenmez. Outlook.com, Hotmail.com veya Live.com etki alanlarındaki hesaplar 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 yönetici olarak bir Microsoft Entra kullanıcı 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ıyı yönetici olarak sağlar.

Parametreler

-Confirm

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

Parametre özellikleri

Tür:SwitchParameter
Default value:None
Joker karakterleri destekler:False
DontShow:False
Diğer adlar:Cf

Parametre kümeleri

(All)
Position:Named
Zorunlu:False
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:False
Kalan bağımsız değişkenlerden elde edilen değer:False

-DefaultProfile

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

Parametre özellikleri

Tür:IAzureContextContainer
Default value:None
Joker karakterleri destekler:False
DontShow:False
Diğer adlar:AzContext, AzureRmContext, AzureCredential

Parametre kümeleri

(All)
Position:Named
Zorunlu:False
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:False
Kalan bağımsız değişkenlerden elde edilen değer: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.

Parametre özellikleri

Tür:String
Default value:None
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

(All)
Position:2
Zorunlu:True
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:True
Kalan bağımsız değişkenlerden elde edilen değer:False

-InputObject

Kullanılacak yönetilen örnek nesnesi.

Parametre özellikleri

Tür:AzureSqlManagedInstanceModel
Default value:None
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

UseInputObjectParameterSet
Position:Named
Zorunlu:True
İşlem hattından gelen değer:True
Özellik adına göre işlem hattından gelen değer:False
Kalan bağımsız değişkenlerden elde edilen değer:False

-InstanceName

SQL Yönetilen Örneği adı.

Parametre özellikleri

Tür:String
Default value:None
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

UseResourceGroupAndInstanceNameParameterSet
Position:1
Zorunlu:True
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:True
Kalan bağımsız değişkenlerden elde edilen değer:False

-ObjectId

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

Parametre özellikleri

Tür:Guid
Default value:None
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

(All)
Position:3
Zorunlu:True
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:True
Kalan bağımsız değişkenlerden elde edilen değer:False

-ResourceGroupName

Kaynak grubunun adı.

Parametre özellikleri

Tür:String
Default value:None
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

UseResourceGroupAndInstanceNameParameterSet
Position:0
Zorunlu:True
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:True
Kalan bağımsız değişkenlerden elde edilen değer:False

-ResourceId

Kullanılacak örneğin kaynak kimliği

Parametre özellikleri

Tür:String
Default value:None
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

UserResourceIdParameterSet
Position:0
Zorunlu:True
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:True
Kalan bağımsız değişkenlerden elde edilen değer:False

-WhatIf

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

Parametre özellikleri

Tür:SwitchParameter
Default value:None
Joker karakterleri destekler:False
DontShow:False
Diğer adlar:Wi

Parametre kümeleri

(All)
Position:Named
Zorunlu:False
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:False
Kalan bağımsız değişkenlerden elde edilen değer:False

CommonParameters

Bu cmdlet yaygın parametreleri destekler: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction ve -WarningVariable. Daha fazla bilgi için bkz. about_CommonParameters.

Girişler

String

Guid

Çıkışlar

AzureSqlInstanceActiveDirectoryAdministratorModel