Set-AzSqlServerActiveDirectoryAdministrator

  • Référence
Module:
Az.Sql

Provisionne un administrateur Microsoft Entra pour SQL Server.

Syntax

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

Description

L’applet de commande Set-AzSqlServerActiveDirectory Administration istrator 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

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

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

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

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

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

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

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

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
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

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

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

-DisplayName

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

Type:String
Position:2
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ResourceGroupName

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

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

-ServerName

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

Type:String
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Entrées

String

Guid

Sorties

AzureSqlServerActiveDirectoryAdministratorModel