Partager via

Set-MsolServicePrincipal

  • Référence
Module:
MSOnline

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