Share via

Get-MsolServicePrincipal

  • Reference
Modul:
MSOnline

Získá instanční objekty z 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

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í hlavní název služby, který začíná aplikací MyApp. Jedná se o přesnou shodu části appClass hlavního názvu služby 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 vrátí všechny výsledky. Nezadávejte společně s parametrem MaxResults .

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

-AppPrincipalId

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

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

-MaxResults

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

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

-ObjectId

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

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

-SearchString

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

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

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

-TenantId

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

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

Výstupy

Microsoft.Online.Administration.ServicePrincipal[]

Tato rutina vrátí instanční objekt nebo seznam instančních objektů z 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ý.