Set-MsolServicePrincipal
Met à jour un principal de service dans Microsoft Azure Active Directory.
Syntaxe
Set-MsolServicePrincipal
[-ObjectId <Guid>]
[-AppPrincipalId <Guid>]
[-DisplayName <String>]
[-ServicePrincipalNames <String[]>]
[-AccountEnabled <Boolean>]
[-Addresses <RedirectUri[]>]
[-TenantId <Guid>]
[<CommonParameters>]
Description
L’applet de commande Set-MsolServicePrincipal met à jour un principal de service dans Microsoft Azure Active Directory. Elle peut servir à mettre à jour le nom d’affichage et à activer/désactiver l’entité de service approuvée en vue de sa délégation, les noms principaux de service (SPN) ou les adresses.
Exemples
Exemple 1 : Modifier les propriétés d’un principal de service
PS C:\> $AppId = (Get-MsolServicePrincipal -ServicePrincipalName "MyApp").AppPrincipalId
PS C:\> Set-MsolServicePrincipal -AppPrincipalId $AppId -DisplayName "My Super Application" -ServicePrincipalNames @("MyApp/myapp.com", "MyApp/mysuperapp.com")
Cette commande met à jour les propriétés sur le principal de service spécifié. Dans cet exemple, il spécifie les mises à jour du nom d’affichage et des noms de service. Les paramètres précédents seront remplacés.
Exemple 2 : Modifier les adresses sur un principal de service
PS C:\> $a = @()
PS C:\> $a = $a + (Get-MsolServicePrincipal -ServicePrincipalName "MyApp").Addresses
PS C:\> $a = $a + (New-MsolServicePrincipalAddresses -Value "myApp1.com")
PS C:\> $a = $a + (New-MsolServicePrincipalAddresses -Value "myApp2.com")
PS C:\> Set-MsolServicePrincipal -AppPrincipalId $AppId -Addresses $a
Cette commande met à jour les adresses d’un principal de service. Dans cet exemple, les adresses existantes qui ont été créées précédemment (« myApp1.com », « myApp2.com ») à l’aide de l’applet de commande New-MsolServicePrincipalAddresses , sont associées au principal du service.
Paramètres
-AccountEnabled
Cette propriété est réservée à une utilisation ultérieure.
Type: | Boolean |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | True |
Accepter les caractères génériques: | False |
-Addresses
Spécifie la liste d’adresses avec laquelle mettre à jour et remplacer la liste existante. Si vous ne spécifiez pas ce paramètre, la propriété existante n’est pas mise à jour. Si vous spécifiez une liste vide, les adresses existantes sont effacées. Utilisez l’applet de commande New-MsolServicePrincipalAddress pour créer l’objet de liste Addresses.
Type: | RedirectUri[] |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | True |
Accepter les caractères génériques: | False |
-AppPrincipalId
Spécifie l’ID d’application unique associé au principal de service à mettre à jour.
Type: | Guid |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | True |
Accepter les caractères génériques: | False |
-DisplayName
Spécifie le nom d’affichage du principal de service.
Type: | String |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | True |
Accepter les caractères génériques: | False |
-ObjectId
Spécifie l’ID d’objet unique du principal de service à mettre à jour.
Type: | Guid |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | True |
Accepter les caractères génériques: | False |
-ServicePrincipalNames
Spécifie la liste des SPN avec lesquels mettre à jour et remplacer l’existant. Si vous ne spécifiez pas ce paramètre, la propriété existante n’est pas mise à jour. Si vous spécifiez une liste vide, les SPN existants sont effacés, à l’exception du SPN qui contient la valeur AppId du principal de service. Un SPN doit utiliser l’un des formats suivants :
appName
appName/hostname
- UNE URL valide
Type: | String[] |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | True |
Accepter les caractères génériques: | False |
-TenantId
Spécifie l’ID unique du locataire sur lequel effectuer l’opération. La valeur par défaut est le locataire de l’utilisateur actuel. Ce paramètre s’applique uniquement aux utilisateurs partenaires.
Type: | Guid |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | True |
Accepter les caractères génériques: | False |