Sdílet prostřednictvím

Get-AzureRmADServicePrincipal

  • Reference
Modul:
AzureRM.Resources

Filtruje instanční objekty služby active directory.

Upozorňující

Modul AzureRM PowerShell byl od 29. února 2024 oficiálně zastaralý. Uživatelům se doporučuje migrovat z AzureRM do modulu Az PowerShell, aby se zajistila nepřetržitá podpora a aktualizace.

I když může modul AzureRM stále fungovat, už se neudržuje ani nepodporuje, přičemž jakékoli další použití se bude umisťovat podle vlastního uvážení a rizika uživatele. Pokyny k přechodu na modul Az najdete v našich zdrojích informací o migraci.

Syntax

Get-AzureRmADServicePrincipal
   [-DefaultProfile <IAzureContextContainer>]
   [-IncludeTotalCount]
   [-Skip <UInt64>]
   [-First <UInt64>]
   [<CommonParameters>]
Get-AzureRmADServicePrincipal
   -DisplayNameBeginsWith <String>
   [-DefaultProfile <IAzureContextContainer>]
   [-IncludeTotalCount]
   [-Skip <UInt64>]
   [-First <UInt64>]
   [<CommonParameters>]
Get-AzureRmADServicePrincipal
   -DisplayName <String>
   [-DefaultProfile <IAzureContextContainer>]
   [-IncludeTotalCount]
   [-Skip <UInt64>]
   [-First <UInt64>]
   [<CommonParameters>]
Get-AzureRmADServicePrincipal
   -ObjectId <Guid>
   [-DefaultProfile <IAzureContextContainer>]
   [-IncludeTotalCount]
   [-Skip <UInt64>]
   [-First <UInt64>]
   [<CommonParameters>]
Get-AzureRmADServicePrincipal
   -ApplicationId <Guid>
   [-DefaultProfile <IAzureContextContainer>]
   [-IncludeTotalCount]
   [-Skip <UInt64>]
   [-First <UInt64>]
   [<CommonParameters>]
Get-AzureRmADServicePrincipal
   -ApplicationObject <PSADApplication>
   [-DefaultProfile <IAzureContextContainer>]
   [-IncludeTotalCount]
   [-Skip <UInt64>]
   [-First <UInt64>]
   [<CommonParameters>]
Get-AzureRmADServicePrincipal
   -ServicePrincipalName <String>
   [-DefaultProfile <IAzureContextContainer>]
   [-IncludeTotalCount]
   [-Skip <UInt64>]
   [-First <UInt64>]
   [<CommonParameters>]

Description

Filtruje instanční objekty služby active directory.

Příklady

Příklad 1 – Výpis instančních objektů AD

PS C:\> Get-AzureRmADServicePrincipal

Zobrazí seznam všech instančních objektů ad v tenantovi.

Příklad 2 – Výpis instančních objektů AD pomocí stránkování

PS C:\> Get-AzureRmADServicePrincipal -First 100

Vypíše prvních 100 instančních objektů ad v tenantovi.

Příklad 3 – Výpis instančních objektů podle hlavního názvu služby

PS C:\> Get-AzureRmADServicePrincipal -ServicePrincipalName 36f81fc3-b00f-48cd-8218-3879f51ff39f

Zobrazí seznam instančních objektů s hlavním názvem služby (SPN) 36f81fc3-b00f-48cd-8218-3879f51ff39f.

Příklad 4 – Výpis instančních objektů podle vyhledávacího řetězce

PS C:\> Get-AzureRmADServicePrincipal -SearchString "Web"

Zobrazí seznam všech instančních objektů SLUŽBY AD, jejichž zobrazovaný název začíná na "Web".

Příklad 5 – Výpis instančních objektů pomocí potrubí

PS C:\> Get-AzureRmADApplication -ObjectId 39e64ec6-569b-4030-8e1c-c3c519a05d69 | Get-AzureRmADServicePrincipal

Získá aplikaci AD s ID objektu 39e64ec6-569b-4030-8e1c-c3c519a05d69 a předá ji rutině Get-AzureRmADServicePrincipal pro výpis všech instančních objektů pro danou aplikaci.

Parametry

-ApplicationId

ID aplikace instančního objektu.

Typ:Guid
Position:Named
výchozí hodnota:None
Vyžadováno:True
Accept pipeline input:True
Accept wildcard characters:False

-ApplicationObject

Objekt aplikace, jehož instanční objekt se načítá.

Typ:PSADApplication
Position:Named
výchozí hodnota:None
Vyžadováno:True
Accept pipeline input:True
Accept wildcard characters:False

-DefaultProfile

Přihlašovací údaje, účet, tenant a předplatné používané ke komunikaci s Azure

Typ:IAzureContextContainer
Aliases:AzureRmContext, AzureCredential
Position:Named
výchozí hodnota:None
Vyžadováno:False
Accept pipeline input:False
Accept wildcard characters:False

-DisplayName

Zobrazovaný název instančního objektu.

Typ:String
Position:Named
výchozí hodnota:None
Vyžadováno:True
Accept pipeline input:True
Accept wildcard characters:False

-DisplayNameBeginsWith

Hledaný řetězec instančního objektu.

Typ:String
Aliases:SearchString
Position:Named
výchozí hodnota:None
Vyžadováno:True
Accept pipeline input:True
Accept wildcard characters:False

-First

Maximální počet objektů, které se mají vrátit.

Typ:UInt64
Position:Named
výchozí hodnota:None
Vyžadováno:False
Accept pipeline input:False
Accept wildcard characters:False

-IncludeTotalCount

Zaznamenává počet objektů v sadě dat. V současné době tento parametr nedělá nic.

Typ:SwitchParameter
Position:Named
výchozí hodnota:None
Vyžadováno:False
Accept pipeline input:False
Accept wildcard characters:False

-ObjectId

ID objektu instančního objektu.

Typ:Guid
Position:Named
výchozí hodnota:None
Vyžadováno:True
Accept pipeline input:True
Accept wildcard characters:False

-ServicePrincipalName

Hlavní název služby (SPN) služby.

Typ:String
Aliases:SPN
Position:Named
výchozí hodnota:None
Vyžadováno:True
Accept pipeline input:True
Accept wildcard characters:False

-Skip

Ignoruje první N objekty a získá zbývající objekty.

Typ:UInt64
Position:Named
výchozí hodnota:None
Vyžadováno:False
Accept pipeline input:False
Accept wildcard characters:False

Vstupy

String

Guid

PSADApplication

Parametry: ApplicationObject (ByValue)

Výstupy

PSADServicePrincipal