Set-AzureRmSqlServerActiveDirectoryAdministrator

  • Riferimento
Modulo:
AzureRM.Sql

Effettua il provisioning di un amministratore di Microsoft Entra per SQL Server.

Avviso

Il modulo AzureRM PowerShell è stato ufficialmente deprecato a partire dal 29 febbraio 2024. È consigliabile eseguire la migrazione da AzureRM al modulo Az PowerShell per garantire il supporto e gli aggiornamenti continui.

Anche se il modulo AzureRM può ancora funzionare, non è più gestito o supportato, posizionando qualsiasi uso continuo a discrezione e rischio dell'utente. Per indicazioni sulla transizione al modulo Az, vedere le risorse di migrazione.

Sintassi

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

Descrizione

Il cmdlet Set-AzureRmSqlServerActiveDirectory Amministrazione istrator effettua il provisioning di un amministratore di Microsoft Entra per Il server AzureSQL 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 Server:

  • Membri nativi di Microsoft Entra ID
  • Membri federati di Microsoft Entra ID
  • Membri importati da altri unità di accesso di Azure che sono membri nativi o federati
  • I gruppi di Microsoft Entra creati come account Microsoft dei gruppi di sicurezza, 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 server

PS C:\>Set-AzureRmSqlServerActiveDirectoryAdministrator -ResourceGroupName "ResourceGroup01" -ServerName "Server01" -DisplayName "DBAs" 
ResourceGroupName ServerName DisplayName ObjectId 
----------------- ---------- ----------- -------- 
ResourceGroup01   Server01   DBAs        40b79501-b343-44ed-9ce7-da4c8cc7353b

Questo comando effettua il provisioning di un gruppo di amministratori di Microsoft Entra denominato DBAs per il server denominato Server01. Questo server è associato al gruppo di risorse ResourceGroup01.

Esempio 2: Effettuare il provisioning di un utente amministratore per un server

PS C:\>Set-AzureRmSqlServerActiveDirectoryAdministrator -ResourceGroupName "ResourceGroup01" -ServerName "Server01" -DisplayName "David Chew"
ResourceGroupName ServerName DisplayName ObjectId 
----------------- ---------- ----------- -------- 
resourcegroup01   server01   David Chew  11E95548-B179-4FE1-9AF4-ACA49D13ABB9

Questo comando effettua il provisioning di un utente di Microsoft Entra come amministratore del server denominato Server01.

Esempio 3: Effettuare il provisioning di un gruppo di amministratori specificandone l'ID

PS C:\>Set-AzureRmSqlServerActiveDirectoryAdministrator -ResourceGroupName "ResourceGroup01" -ServerName "Server01" -DisplayName "DBAs" -ObjectId "40b79501-b343-44ed-9ce7-da4c8cc7353b"
ResourceGroupName ServerName DisplayName ObjectId 
----------------- ---------- ----------- -------- 
ResourceGroup01   Server01   DBAs        40b79501-b343-44ed-9ce7-da4c8cc7353b

Questo comando effettua il provisioning di un gruppo di amministratori di Microsoft Entra denominato DBAs per il server denominato Server01. Il comando specifica un ID per il parametro ObjectId . Ciò garantisce che il comando abbia esito positivo anche se il nome visualizzato del gruppo non è univoco.

Parametri

-Confirm

Richiede conferma prima di eseguire il cmdlet.

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

-DefaultProfile

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

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

-DisplayName

Specifica il nome visualizzato dell'amministratore di Microsoft Entra di cui esegue il provisioning.

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

-ObjectId

Specifica l'ID univoco dell'amministratore di Microsoft Entra di cui esegue il provisioning. Se il nome visualizzato non è univoco, è necessario specificare un valore per questo parametro.

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

-ResourceGroupName

Specifica il nome del gruppo di risorse a cui è assegnato il server.

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

-ServerName

Specifica il nome di SQL Server per il quale questo cmdlet effettua il provisioning di un amministratore.

Type:String
Position:1
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:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Input

String

Guid

Output

AzureSqlServerActiveDirectoryAdministratorModel