Dela via

Get-MsolServicePrincipal

  • Referens
Modul:
MSOnline

Hämtar tjänstens huvudnamn från 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

Cmdleten Get-MsolServicePrincipal hämtar ett huvudnamn för tjänsten eller en lista över tjänstens huvudnamn från Azure Active Directory.

Exempel

Exempel 1: Visa alla tjänstens huvudnamn

PS C:\> Get-MsolServicePrincipal

Det här kommandot visar alla befintliga tjänsthuvudnamn i organisationens klientorganisation.

Exempel 2: Hämta tjänstens huvudnamn med hjälp av ett namn

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

Det här kommandot hämtar alla befintliga tjänsthuvudnamn som har ett namn på tjänstens huvudnamn som börjar med MyApp. Detta är en exakt matchning av appClass-delen av tjänstens huvudnamn upp till snedstrecket.

Exempel 3: Hämta ett huvudnamn för tjänsten

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

Det här kommandot hämtar ett huvudnamn för tjänsten som har ett specifikt programhuvudnamns-ID.

Parametrar

-All

Anger att den här cmdleten returnerar alla resultat. Ange inte tillsammans med parametern MaxResults .

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-AppPrincipalId

Anger det unika program-ID för tjänstens huvudnamn som ska hämtas.

Typ:Guid
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-MaxResults

Anger det maximala antalet resultat som den här cmdleten returnerar. Standardvärdet är 500.

Typ:Int32
Position:Named
Standardvärde:500
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-ObjectId

Anger det unika objekt-ID för tjänstens huvudnamn som ska hämtas.

Typ:Guid
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-SearchString

Anger en sträng som matchar tjänstens huvudnamn.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-ServicePrincipalName

Anger namnet på tjänstens huvudnamn eller tjänstens huvudnamn som ska hämtas. Ett SPN måste använda något av följande format:

  • appName
  • appName/hostname
  • en giltig URL

AppName representerar namnet på programmet och värdnamnet representerar URI-utfärdaren för programmet.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-TenantId

Anger det unika ID för klientorganisationen som åtgärden ska utföras på. Standardvärdet är den aktuella användarens klientorganisation. Den här parametern gäller endast för partneranvändare.

Typ:Guid
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

Utdata

Microsoft.Online.Administration.ServicePrincipal[]

Den här cmdleten returnerar ett huvudnamn för tjänsten eller en lista över tjänstens huvudnamn från Azure Active Directory. Varje huvudnamn för tjänsten innehåller följande information:

  • Objectid. Den unika identifieraren för tjänstens huvudnamn.
  • AppPrincipalId. Programidentifieraren för tjänstens huvudnamn.
  • Displayname. Det egna namnet på tjänstens huvudnamn.
  • ServicePrincipalName. Listan över tjänsthuvudnamn (SPN) som är associerade med tjänstens huvudnamn.
  • AccountEnabled. Värdet som anger om kontot är aktiverat.