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

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

Entrées

IMicrosoftGraphApplication

Sorties

IMicrosoftGraphServicePrincipal