Get-MsolServicePrincipal

  • Referentie
Module:
MSOnline

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

Syntax

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 ophaalt die een service-principalnaam hebben die begint met MyApp. Dit is een exacte overeenkomst van het appClass-gedeelte van de service-principal-naam 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 met een specifieke toepassings-principal-id ophaalt.

Parameters

-All

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

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-AppPrincipalId

Hiermee geeft u de unieke toepassings-id van de service-principal op die moet worden get.

Type:Guid
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-MaxResults

Hiermee geeft u het maximum aantal resultaten op dat door deze cmdlet wordt geretourneerd. De standaardwaarde is 500.

Type:Int32
Position:Named
Default value:500
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ObjectId

Hiermee geeft u de unieke object-id van de service-principal op die moet worden opgehaald.

Type:Guid
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-SearchString

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ServicePrincipalName

Hiermee geeft u de naam van de service-principal of service-principals op die moeten worden get. Een SPN moet een van de volgende indelingen gebruiken:

  • appName
  • appName/hostname
  • een geldige URL

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

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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
Required:False
Accept pipeline input:True
Accept wildcard characters: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.