Sdílet prostřednictvím

Get-MsolServicePrincipal

  • Reference
Modul:
MSOnline

Získá instanční objekty z Azure Active Directory.

Syntaxe

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

Rutina Get-MsolServicePrincipal získá instanční objekt nebo seznam instančních objektů z Azure Active Directory.

Příklady

Příklad 1: Zobrazení všech instančních objektů

PS C:\> Get-MsolServicePrincipal

Tento příkaz zobrazí všechny existující instanční objekty v tenantovi organizace.

Příklad 2: Získání instančních objektů pomocí názvu

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

Tento příkaz získá všechny existující instanční objekty, které mají název instančního objektu, který začíná na MyApp. Jedná se o přesnou shodu části appClass názvu instančního objektu až po lomítko.

Příklad 3: Získání instančního objektu

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

Tento příkaz získá instanční objekt, který má konkrétní ID instančního objektu aplikace.

Parametry

-All

Označuje, že tato rutina vrací všechny výsledky. Nezadávejte společně s parametrem MaxResults .

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-AppPrincipalId

Určuje jedinečné ID aplikace instančního objektu, který se má získat.

Typ:Guid
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-MaxResults

Určuje maximální počet výsledků, které tato rutina vrátí. Výchozí hodnota je 500.

Typ:Int32
Position:Named
Default value:500
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-ObjectId

Určuje jedinečné ID objektu instančního objektu, který se má získat.

Typ:Guid
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-SearchString

Určuje řetězec, který se má shodovat s hlavními názvy služby.

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-ServicePrincipalName

Určuje název instančního objektu nebo instančních objektů, které se mají získat. Hlavní název služby (SPN) musí používat jeden z následujících formátů:

  • appName
  • appName/hostname
  • platná adresa URL

AppName představuje název aplikace a název hostitele představuje autoritu URI pro aplikaci.

Typ:String
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-TenantId

Určuje jedinečné ID tenanta, na kterém se má operace provést. Výchozí hodnota je tenant aktuálního uživatele. Tento parametr platí jenom pro uživatele partnerů.

Typ:Guid
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

Výstupy

Microsoft.Online.Administration.ServicePrincipal[]

Tato rutina vrátí instanční objekt nebo seznam instančních objektů ze služby Azure Active Directory. Každý instanční objekt obsahuje následující informace:

  • Objectid. Jedinečný identifikátor instančního objektu.
  • AppPrincipalId. Identifikátor aplikace instančního objektu.
  • Displayname. Popisný název instančního objektu.
  • ServicePrincipalName. Seznam hlavních názvů služby (SPN) přidružených k instančnímu objektu.
  • AccountEnabled. Hodnota označující, jestli je účet povolený.