Partager via

Set-AzureRmSqlServerActiveDirectoryAdministrator

  • Référence
Module:
AzureRM.Sql

Provisionne un administrateur Microsoft Entra pour SQL Server.

Avertissement

Le module AzureRM PowerShell a été officiellement déprécié le 29 février 2024. Les utilisateurs sont invités à migrer d’AzureRM vers le module Az PowerShell afin de s’assurer d’une prise en charge et des mises à jour continues.

Il est possible que le module AzureRM fonctionne encore, mais il ne fait plus l’objet de maintenance ni de support. L’utilisateur peut continuer à s’en servir s’il le souhaite, à ses propres risques. Consultez nos ressources sur la migration pour obtenir des conseils sur la transition vers le module Az.

Syntaxe

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

Description

L’applet de commande Set-AzureRmSqlServerActiveDirectoryAdministrator provisionne un administrateur Microsoft Entra pour AzureSQL Server dans l’abonnement actuel. Vous ne pouvez provisionner qu’un seul administrateur à la fois. Les membres suivants de l’ID Microsoft Entra peuvent être provisionnés en tant qu’administrateur SQL Server :

  • Membres natifs de Microsoft Entra ID
  • Membres fédérés de l’ID Microsoft Entra
  • Membres importés à partir d’autres AD Azure qui sont des membres natifs ou fédérés
  • Les groupes Microsoft Entra créés en tant que comptes Microsoft de groupes de sécurité, tels que ceux des domaines Outlook.com, Hotmail.com ou Live.com, ne sont pas pris en charge en tant qu’administrateurs. D’autres comptes invités, tels que ceux des domaines Gmail.com ou Yahoo.com, ne sont pas pris en charge en tant qu’administrateurs. Nous vous recommandons de provisionner un groupe Microsoft Entra dédié en tant qu’administrateur.

Exemples

Exemple 1 : Provisionner un groupe d’administrateurs pour un serveur

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

Cette commande provisionne un groupe d’administrateurs Microsoft Entra nommé DBAs pour le serveur nommé Server01. Ce serveur est associé au groupe de ressources ResourceGroup01.

Exemple 2 : Provisionner un utilisateur administrateur pour un serveur

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

Cette commande provisionne un utilisateur Microsoft Entra en tant qu’administrateur pour le serveur nommé Server01.

Exemple 3 : Provisionner un groupe d’administrateurs en spécifiant son 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

Cette commande provisionne un groupe d’administrateurs Microsoft Entra nommé DBAs pour le serveur nommé Server01. La commande spécifie un ID pour le paramètre ObjectId . Cela garantit que la commande réussit même si le nom complet du groupe n’est pas unique.

Paramètres

-Confirm

Vous demande une confirmation avant d’exécuter l’applet de commande.

Type:SwitchParameter
Alias:cf
Position:Named
Valeur par défaut:False
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-DefaultProfile

Informations d’identification, compte, locataire et abonnement utilisés pour la communication avec Azure

Type:IAzureContextContainer
Alias:AzureRmContext, AzureCredential
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-DisplayName

Spécifie le nom complet de l’administrateur Microsoft Entra que cette applet de commande provisionne.

Type:String
Position:2
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-ObjectId

Spécifie l’ID unique de l’administrateur Microsoft Entra que cette applet de commande provisionne. Si le nom complet n’est pas unique, vous devez spécifier une valeur pour ce paramètre.

Type:Guid
Position:3
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-ResourceGroupName

Spécifie le nom du groupe de ressources auquel le serveur est affecté.

Type:String
Position:0
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-ServerName

Spécifie le nom du serveur SQL Server pour lequel cette applet de commande provisionne un administrateur.

Type:String
Position:1
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-WhatIf

Montre ce qui se passe en cas d’exécution de l’applet de commande. L’applet de commande n’est pas exécutée.

Type:SwitchParameter
Alias:wi
Position:Named
Valeur par défaut:False
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

Entrées

String

Guid

Sorties

AzureSqlServerActiveDirectoryAdministratorModel