Get-ServicePrincipal
Cette cmdlet est disponible uniquement dans le service cloud.
Utilisez l’applet de commande Get-ServicePrincipal pour afficher des informations sur les principaux de service dans votre organization cloud.
Pour plus d’informations sur les jeux de paramètres dans la section Syntaxe ci-après, voir Syntaxe da la cmdlet Exchange.
Syntaxe
Default (Par défaut)
Get-ServicePrincipal
[[-Identity] <ServicePrincipalIdParameter>]
[-Organization <OrganizationIdParameter>]
[<CommonParameters>]
Description
Des principaux de service existent dans Microsoft Entra ID pour définir ce que les applications peuvent faire, qui peut accéder aux applications et les ressources auxquelles les applications peuvent accéder. Dans Exchange Online, les principaux de service sont des références aux principaux de service dans Microsoft Entra ID. Pour attribuer Exchange Online rôles de contrôle d’accès en fonction du rôle (RBAC) aux principaux de service dans Microsoft Entra ID, vous utilisez les références de principal de service dans Exchange Online. Les applets de commande *-ServicePrincipal dans Exchange Online PowerShell vous permettent d’afficher, de créer et de supprimer ces références de principal de service.
Pour plus d’informations, consultez Objets application et principal de service dans Microsoft Entra ID.
Des autorisations doivent vous être attribuées avant de pouvoir exécuter cette cmdlet. Bien que cet article répertorie tous les paramètres de l’applet de commande, il se peut que vous n’ayez pas accès à certains paramètres s’ils ne sont pas inclus dans les autorisations qui vous sont attribuées. Pour rechercher les autorisations requises pour exécuter une cmdlet ou un paramètre dans votre organisation, voir Find the permissions required to run any Exchange cmdlet.
Exemples
Exemple 1
Get-ServicePrincipal
Cet exemple retourne une liste récapitulative de tous les principaux de service au sein d’un organization.
Exemple 2
Get-ServicePrincipal -Identity ca73fffa-cedb-4b84-860f-d7fb8aa8a6c1 | Format-List
Cet exemple retourne des informations détaillées sur le principal de service avec la valeur ObjectId ca73fffa-cedb-4b84-860f-d7fb8aa8a6c1.
Paramètres
-Identity
Applicable : Exchange Online, Sécurité & Conformité, Module complémentaire de sécurité intégré pour les boîtes aux lettres locales
Le paramètre Identity spécifie le principal de service que vous souhaitez afficher. Vous pouvez utiliser n’importe quelle valeur qui identifie de manière unique le principal de service. Par exemple :
- Nom
- Nom unique (DN)
- GUID
- Appid
- ObjectId
Attention : la valeur $null ou une valeur inexistante pour le paramètre Identity retourne tous les objets comme si vous exécutiez la commande Get- sans le paramètre Identity. Vérifiez que les listes de valeurs du paramètre Identity sont exactes et ne contiennent pas de valeurs $null inexistantes.
Propriétés du paramètre
| Type: | ServicePrincipalIdParameter |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | 0 |
| Obligatoire: | False |
| Valeur du pipeline: | True |
| Valeur du pipeline par nom de propriété: | True |
| Valeur des arguments restants: | False |
-Organization
Applicable : Exchange Online, Sécurité & Conformité, Module complémentaire de sécurité intégré pour les boîtes aux lettres locales
Ce paramètre est réservé à l’usage interne chez Microsoft.
Propriétés du paramètre
| Type: | OrganizationIdParameter |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
CommonParameters
Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.