Condividi tramite

Set-AzSqlInstanceActiveDirectoryAdministrator

Modulo:
Az.Sql Module

Effettua il provisioning di un amministratore di Microsoft Entra per SQL Managed Instance.

Sintassi

UseResourceGroupAndInstanceNameParameterSet (Impostazione predefinita) 

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

Descrizione

Il cmdlet Set-AzSqlInstanceActiveDirectoryAdministrator effettua il provisioning di un amministratore Microsoft Entra per AzureSQL Managed Instance 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 SQL Managed Instance:

  • Membri nativi di Microsoft Entra ID
  • Membri federati di Microsoft Entra ID
  • Microsoft Entra gruppi creati come gruppi di sicurezza Membri importati da altri id 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 di 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 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 Microsoft Entra come amministratore dall'oggetto 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 Microsoft Entra come amministratore usando l'identificatore di risorsa dell'istanza gestita.

Parametri

-Confirm

Richiede conferma prima di eseguire il cmdlet.

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False
Alias:Cfr

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-DefaultProfile

Credenziali, account, tenant e sottoscrizione usati per la comunicazione con Azure.

Proprietà dei parametri

Tipo:IAzureContextContainer
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False
Alias:AzContext, AzureRmContext, AzureCredential

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti: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.

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:2
Obbligatorio:True
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False

-InputObject

Oggetto dell'istanza gestita da utilizzare.

Proprietà dei parametri

Tipo:AzureSqlManagedInstanceModel
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

UseInputObjectParameterSet
Posizione:Named
Obbligatorio:True
Valore dalla pipeline:True
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-InstanceName

SQL Managed Instance nome.

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

UseResourceGroupAndInstanceNameParameterSet
Posizione:1
Obbligatorio:True
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False

-ObjectId

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

Proprietà dei parametri

Tipo:Guid
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:3
Obbligatorio:True
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False

-ResourceGroupName

Nome del gruppo di risorse.

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

UseResourceGroupAndInstanceNameParameterSet
Posizione:0
Obbligatorio:True
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False

-ResourceId

ID risorsa dell'istanza da usare

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

UserResourceIdParameterSet
Posizione:0
Obbligatorio:True
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False

-WhatIf

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

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False
Alias:Wi

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

CommonParameters

Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedi about_CommonParameters.

Input

String

Guid

Output

AzureSqlInstanceActiveDirectoryAdministratorModel