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

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.

Tipo:SwitchParameter
Alias:cf
Posizione:Named
Valore predefinito:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-DefaultProfile

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

Tipo:IAzureContextContainer
Alias:AzContext, AzureRmContext, AzureCredential
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-DisplayName

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

Tipo:String
Posizione:2
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly: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.

Tipo:Guid
Posizione:3
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-ResourceGroupName

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

Tipo:String
Posizione:0
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-ServerName

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

Tipo:String
Posizione:1
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-WhatIf

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

Tipo:SwitchParameter
Alias:wi
Posizione:Named
Valore predefinito:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

Input

String

Guid

Output

AzureSqlServerActiveDirectoryAdministratorModel