Delen via

Get-MsolServicePrincipal

  • Referentie
Module:
MSOnline

Hiermee haalt u service-principals op uit Azure Active Directory.

Syntaxis

Get-MsolServicePrincipal
   [-SearchString <String>]
   [-MaxResults <Int32>]
   [-TenantId <Guid>]
   [<CommonParameters>]
Get-MsolServicePrincipal
   -ObjectId <Guid>
   [-TenantId <Guid>]
   [<CommonParameters>]
Get-MsolServicePrincipal
   -AppPrincipalId <Guid>
   [-TenantId <Guid>]
   [<CommonParameters>]
Get-MsolServicePrincipal
   -ServicePrincipalName <String>
   [-TenantId <Guid>]
   [<CommonParameters>]
Get-MsolServicePrincipal
   [-SearchString <String>]
   [-All]
   [-TenantId <Guid>]
   [<CommonParameters>]

Description

De cmdlet Get-MsolServicePrincipal haalt een service-principal of een lijst met service-principals op uit Azure Active Directory.

Voorbeelden

Voorbeeld 1: alle service-principals weergeven

PS C:\> Get-MsolServicePrincipal

Met deze opdracht worden alle bestaande service-principals in de tenant van de organisatie weergegeven.

Voorbeeld 2: Service-principals ophalen met behulp van een naam

PS C:\> Get-MsolServicePrincipal -ServicePrincipalName "MyApp"

Met deze opdracht worden alle bestaande service-principals met een service-principal-naam die begint met MyApp. Dit is een exacte overeenkomst van het appClass-gedeelte van de naam van de service-principal tot de slash.

Voorbeeld 3: Een service-principal ophalen

PS C:\> Get-MsolServicePrincipal -AppPrincipalId 5e964d2f-e384-4292-ae55-dd24c89cc53b

Met deze opdracht wordt een service-principal opgehaald met een specifieke toepassings-principal-id.

Parameters

-All

Geeft aan dat deze cmdlet alle resultaten retourneert. Geef niet op samen met de parameter MaxResults .

Type:SwitchParameter
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-AppPrincipalId

Hiermee geeft u de unieke toepassings-id van de service-principal op te halen.

Type:Guid
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-MaxResults

Hiermee geeft u het maximum aantal resultaten dat deze cmdlet retourneert. De standaardwaarde is 500.

Type:Int32
Position:Named
Default value:500
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-ObjectId

Hiermee geeft u de unieke object-id van de service-principal op te halen.

Type:Guid
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-SearchString

Hiermee geeft u een tekenreeks op die overeenkomt met de namen van service-principals.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-ServicePrincipalName

Hiermee geeft u de naam van de service-principal of service-principals op te halen. Een SPN moet een van de volgende indelingen gebruiken:

  • appName
  • appName/hostname
  • een geldige URL

AppName vertegenwoordigt de naam van de toepassing en hostnaam staat voor de URI-instantie voor de toepassing.

Type:String
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-TenantId

Hiermee geeft u de unieke id van de tenant op waarop de bewerking moet worden uitgevoerd. De standaardwaarde is de tenant van de huidige gebruiker. Deze parameter is alleen van toepassing op partnergebruikers.

Type:Guid
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

Uitvoerwaarden

Microsoft.Online.Administration.ServicePrincipal[]

Deze cmdlet retourneert een service-principal of een lijst met service-principals uit Azure Active Directory. Elke service-principal bevat de volgende informatie:

  • ObjectId. De unieke id van de service-principal.
  • AppPrincipalId. De toepassings-id van de service-principal.
  • Displayname. De beschrijvende naam van de service-principal.
  • ServicePrincipalName. De lijst met service-principalnamen (SPN's) die zijn gekoppeld aan de service-principal.
  • AccountEnabled. De waarde die aangeeft of het account is ingeschakeld.