Set-AzSqlInstanceActiveDirectoryAdministrator

  • Riferimento
Modulo:
Az.Sql

Effettua il provisioning di un amministratore di Microsoft Entra per Istanza gestita di SQL.

Sintassi

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

Descrizione

Il cmdlet Set-AzSqlInstanceActiveDirectory Amministrazione istrator effettua il provisioning di un amministratore di Microsoft Entra per Azure Istanza gestita di SQL nella sottoscrizione corrente. È possibile effettuare il provisioning di un solo amministratore alla volta. È possibile effettuare il provisioning dei membri seguenti di Microsoft Entra ID come amministratore di Istanza gestita di SQL:

  • Membri nativi di Microsoft Entra ID
  • Membri federati di Microsoft Entra ID
  • I gruppi di Microsoft Entra creati come gruppi di sicurezza Membri importati da altri dischi AD di Azure non sono supportati come amministratori. Gli account Microsoft, ad esempio quelli nel Outlook.com, Hotmail.com o Live.com domini, non sono supportati come amministratori. Altri account guest, ad esempio quelli nel Gmail.com o Yahoo.com domini, non sono supportati come amministratori. È consigliabile effettuare il provisioning di un gruppo Microsoft Entra dedicato come amministratore.

Esempio

Esempio 1: Effettuare il provisioning di un gruppo di amministratori per un'istanza gestita associata al gruppo di risorse

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

Questo comando effettua il provisioning di un gruppo di amministratori di Microsoft Entra denominato DBAs per l'istanza gestita denominata ManagedInstance01. Questo server è associato al gruppo di risorse ResourceGroup01.

Esempio 2: Effettuare il provisioning di un utente amministratore usando l'oggetto istanza gestita

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

Questo comando effettua il provisioning di un utente di Microsoft Entra come amministratore dell'oggetto dell'istanza gestita.

Esempio 3: Effettuare il provisioning di un amministratore usando l'identificatore di risorsa dell'istanza gestita

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

Questo comando effettua il provisioning di un utente di Microsoft Entra come amministratore usando l'identificatore di risorsa dell'istanza gestita.

Parametri

-Confirm

Richiede conferma prima di eseguire il cmdlet.

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

-DefaultProfile

Le credenziali, l’account, il tenant e la sottoscrizione usati per comunicare con Azure.

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

-DisplayName

Specifica il nome visualizzato dell'utente o del gruppo per cui concedere le autorizzazioni. Questo nome visualizzato deve esistere nella directory active directory associata alla sottoscrizione corrente.

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

-InputObject

Oggetto dell'istanza gestita da utilizzare.

Type:AzureSqlManagedInstanceModel
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-InstanceName

Istanza gestita di SQL nome.

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

-ObjectId

Specifica l'ID oggetto dell'utente o del gruppo in MICROSOFT Entra ID per cui concedere le autorizzazioni.

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

-ResourceGroupName

Nome del gruppo di risorse.

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

-ResourceId

ID risorsa dell'istanza da usare

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

-WhatIf

Mostra gli effetti dell'esecuzione del cmdlet. Il cmdlet non viene eseguito.

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

Input

String

Guid

Output

AzureSqlInstanceActiveDirectoryAdministratorModel