Get-MsolServicePrincipalCredential

  • Referentie
Module:
MSOnline

Hiermee haalt u referenties op die zijn gekoppeld aan een service-principal.

Syntax

Get-MsolServicePrincipalCredential
   -ObjectId <Guid>
   -ReturnKeyValues <Boolean>
   [-TenantId <Guid>]
   [<CommonParameters>]
Get-MsolServicePrincipalCredential
   -ReturnKeyValues <Boolean>
   -AppPrincipalId <Guid>
   [-TenantId <Guid>]
   [<CommonParameters>]
Get-MsolServicePrincipalCredential
   -ReturnKeyValues <Boolean>
   -ServicePrincipalName <String>
   [-TenantId <Guid>]
   [<CommonParameters>]

Description

De cmdlet Get-MsolServicePrincipalCredential haalt referenties op die zijn gekoppeld aan een service-principal.

Voorbeelden

Voorbeeld 1: Referentie-eigenschappen ophalen

PS C:\> Get-MsolServicePrincipalCredential -ServicePrincipalName "MyApp/myApp.com"

Met deze opdracht worden alle referentie-eigenschappen opgehaald, met uitzondering van de referentiewaarde, die zijn gekoppeld aan de service-principal name (SPN) MyApp/myApp.com. Een SPN moet de indeling appClass/hostnaam volgen, waarbij appClass de toepassingsklasse ("MyApp") vertegenwoordigt en hostnaam de hostnaam voor de toepassing vertegenwoordigt (myApp.com).

Parameters

-AppPrincipalId

Hiermee geeft u de toepassings-id van de service-principal op waarvoor referenties moeten worden opgeslagen.

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

-ObjectId

Hiermee geeft u de unieke object-id van de service-principal op waarvoor referenties moeten worden opgehaald.

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

-ReturnKeyValues

Geeft aan of deze cmdlet sleutelwaarden retourneert.

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

-ServicePrincipalName

Hiermee geeft u de naam van de service-principal waaruit referenties moeten worden opgehaald. Een SPN moet een van de volgende indelingen gebruiken:

  • appName
  • appName/hostname
  • een geldige URL

AppName vertegenwoordigt de naam van de toepassing. 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.ServicePrincipalCredential[]

Met deze cmdlet worden de referenties geretourneerd die zijn gekoppeld aan een service-principal. Elk geretourneerd object bevat de volgende informatie:

  • Type. Het type service-principalreferentie (asymmetrisch/symmetrisch/wachtwoord).
  • Waarde. De waarde van de referentie.
    • Als het referentietype certificaat is, vertegenwoordigt dit het met base 64 gecodeerde certificaat.
    • Als het referentietype symmetrisch is, vertegenwoordigt dit een AES-sleutel.
  • KeyGroupId. De id die is gereserveerd voor intern gebruik.
  • KeyId. De unieke id van de sleutel.
  • Startdate. De effectieve begindatum van het referentiegebruik.
  • Enddate. De effectieve einddatum van het referentiegebruik.
  • Gebruik. Hiermee geeft u op of de referentie wordt gebruikt om een token te ondertekenen of te verifiëren.