Get-AzADServicePrincipal
Répertorie les entités à partir de principaux de service ou obtient une entité à partir de principaux de service par clé
Syntaxe
Get-AzADServicePrincipal
[-Select <String[]>]
[-Count]
[-Filter <String>]
[-Orderby <String[]>]
[-Search <String>]
[-ConsistencyLevel <String>]
[-First <UInt64>]
[-Skip <UInt64>]
[-AppendSelected]
[-DefaultProfile <PSObject>]
[-CountVariable <String>]
[<CommonParameters>]
Get-AzADServicePrincipal
-ObjectId <String>
[-Select <String[]>]
[-First <UInt64>]
[-Skip <UInt64>]
[-AppendSelected]
[-DefaultProfile <PSObject>]
[<CommonParameters>]
Get-AzADServicePrincipal
[-Select <String[]>]
-DisplayNameBeginsWith <String>
[-First <UInt64>]
[-Skip <UInt64>]
[-AppendSelected]
[-DefaultProfile <PSObject>]
[<CommonParameters>]
Get-AzADServicePrincipal
[-Select <String[]>]
-DisplayName <String>
[-First <UInt64>]
[-Skip <UInt64>]
[-AppendSelected]
[-DefaultProfile <PSObject>]
[<CommonParameters>]
Get-AzADServicePrincipal
[-Select <String[]>]
-ApplicationId <Guid>
[-First <UInt64>]
[-Skip <UInt64>]
[-AppendSelected]
[-DefaultProfile <PSObject>]
[<CommonParameters>]
Get-AzADServicePrincipal
[-Select <String[]>]
-ApplicationObject <IMicrosoftGraphApplication>
[-First <UInt64>]
[-Skip <UInt64>]
[-AppendSelected]
[-DefaultProfile <PSObject>]
[<CommonParameters>]
Get-AzADServicePrincipal
[-Select <String[]>]
-ServicePrincipalName <String>
[-First <UInt64>]
[-Skip <UInt64>]
[-AppendSelected]
[-DefaultProfile <PSObject>]
[<CommonParameters>]
Description
Répertorie les entités à partir de principaux de service ou obtient une entité à partir de principaux de service par clé
Exemples
Exemple 1 : Obtenir le principal de service par nom d’affichage
Get-AzADServicePrincipal -DisplayName $name
Obtenir le principal de service par nom d’affichage
Exemple 2 : La recherche du nom d’affichage du principal de service commence par
Get-AzADServicePrincipal -DisplayNameStartsWith $prefix
La recherche du nom d’affichage du principal de service commence par
Exemple 3 : Répertorier les principaux de service
Get-AzADServicePrincipal -First 10 -Select Tags -AppendSelected
Répertorier les 10 premiers principaux de service et ajouter la propriété « Tags » après les propriétés par défaut : « DisplayName », « Id », « DeletedDateTime », « ServicePrincipalNames », « AppId »
Exemple 4 : Obtenir le principal de service par ID d’application
Get-AzADServicePrincipal -ApplicationId $appId
Obtenir le principal de service par ID d’application
Exemple 5 : Obtenir le principal de service par entrée de pipeline
Get-AzADApplication -DisplayName $name | Get-AzADServicePrincipal
Obtenir le principal de service par entrée de pipeline
Exemple 6 : Obtenir un principal de service avec un filtre
Get-AzADServicePrincipal -Filter "startsWith(DisplayName,'some-name')"
Obtenir un principal de service avec un filtre
Exemple 7 : Affecter OdataCount à une variable
Get-AzADServicePrincipal -First 10 -ConsistencyLevel eventual -Count -CountVariable 'result'
$result
Affecter OdataCount à une variable
Paramètres
-AppendSelected
Ajoutez les propriétés sélectionnées avec les propriétés par défaut lorsque ce commutateur est activé, fonctionne uniquement avec le paramètre « -Select ».
Type: | SwitchParameter |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-ApplicationId
ID d’application du serviceprincipal
Type: | Guid |
Alias: | AppId |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | True |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-ApplicationObject
L’objet principal de service peut être utilisé comme entrée de pipeline.
Type: | IMicrosoftGraphApplication |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | True |
Accepter l'entrée de pipeline: | True |
Accepter les caractères génériques: | False |
-ConsistencyLevel
Indique le niveau de cohérence demandé. URL de la documentation : https://developer.microsoft.com/en-us/office/blogs/microsoft-graph-advanced-queries-for-directory-objects-are-now-generally-available/
Type: | String |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-Count
Inclure le nombre d’éléments
Type: | SwitchParameter |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-CountVariable
Spécifie le nombre total d’éléments d’une collection. Par défaut, cette variable est définie dans l’étendue globale.
Type: | String |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-DefaultProfile
Informations d’identification, compte, locataire et abonnement utilisés pour la communication avec Azure.
Type: | PSObject |
Alias: | AzContext, AzureRmContext, AzureCredential |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-DisplayName
nom d’affichage serviceprincipal
Type: | String |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | True |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-DisplayNameBeginsWith
le nom d’affichage serviceprincipal commence par
Type: | String |
Alias: | DisplayNameStartsWith, SearchString |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | True |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-Filter
Filtrez les éléments par valeurs de propriété, pour plus d’informations sur la requête de filtre, consultez : https://video2.skills-academy.com/en-us/graph/filter-query-parameter
Type: | String |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-First
Obtient uniquement les premiers objets 'n'.
Type: | UInt64 |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-ObjectId
clé : ID de servicePrincipal
Type: | String |
Alias: | ServicePrincipalId, Id |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | True |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-Orderby
Classer les éléments par valeurs de propriété
Type: | String[] |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-Search
Rechercher des éléments par expressions de recherche
Type: | String |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-Select
Sélectionner les propriétés à renvoyer
Type: | String[] |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-ServicePrincipalName
nom de serviceprincipal
Type: | String |
Alias: | SPN |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | True |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-Skip
Ignore les premiers objets « n », puis obtient les objets restants.
Type: | UInt64 |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |