Set-AzSqlServerActiveDirectoryAdministrator

  • Riferimento
Modulo:
Az.Sql

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

Sintassi

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

Descrizione

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

Set-AzSqlServerActiveDirectoryAdministrator -ResourceGroupName "ResourceGroup01" -ServerName "Server01" -DisplayName "DBAs"

ResourceGroupName ServerName DisplayName ObjectId IsAzureADOnlyAuthentication
----------------- ---------- ----------- -------- ---------------------------
ResourceGroup01   Server01   DBAs        40b79501-b343-44ed-9ce7-da4c8cc7353b False

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

Set-AzSqlServerActiveDirectoryAdministrator -ResourceGroupName "ResourceGroup01" -ServerName "Server01" -DisplayName "David Chew"

ResourceGroupName ServerName DisplayName ObjectId IsAzureADOnlyAuthentication
----------------- ---------- ----------- -------- 
resourcegroup01   server01   David Chew  11E95548-B179-4FE1-9AF4-ACA49D13ABB9 False

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

Set-AzSqlServerActiveDirectoryAdministrator -ResourceGroupName "ResourceGroup01" -ServerName "Server01" -DisplayName "DBAs" -ObjectId "40b79501-b343-44ed-9ce7-da4c8cc7353b"

ResourceGroupName ServerName DisplayName ObjectId IsAzureADOnlyAuthentication 
----------------- ---------- ----------- -------- 
ResourceGroup01   Server01   DBAs        40b79501-b343-44ed-9ce7-da4c8cc7353b False

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:AzContext, 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