Set-AzureRmSqlServerActiveDirectoryAdministrator
Provisionne un administrateur Microsoft Entra pour SQL Server.
Avertissement
Le module AzureRM PowerShell a été officiellement déconseillé depuis 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.
Bien que le module AzureRM puisse toujours fonctionner, il n’est plus conservé ou pris en charge, plaçant toute utilisation continue à la discrétion et au risque de l’utilisateur. Consultez nos ressources sur la migration pour obtenir des conseils sur la transition vers le module Az.
Syntax
Set-AzureRmSqlServerActiveDirectoryAdministrator
[-DisplayName] <String>
[[-ObjectId] <Guid>]
[-ServerName] <String>
[-ResourceGroupName] <String>
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
L’applet de commande Set-AzureRmSqlServerActiveDirectory 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
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 |
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: | 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
Sorties
AzureSqlServerActiveDirectoryAdministratorModel