Dela via


Get-AzureRmADServicePrincipal

Filtrerar active directory-tjänstens huvudnamn.

Varning

AzureRM PowerShell-modulen är officiellt inaktuell från och med den 29 februari 2024. Användare rekommenderas att migrera från AzureRM till Az PowerShell-modulen för att säkerställa fortsatt support och uppdateringar.

Även om AzureRM-modulen fortfarande kan fungera, underhålls den inte längre eller stöds, vilket gör att användaren kan välja och riskera fortsatt användning. Se våra migreringsresurser för vägledning om övergången till Az-modulen.

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

Filtrerar active directory-tjänstens huvudnamn.

Exempel

Exempel 1 – Lista AD-tjänstens huvudnamn

PS C:\> Get-AzureRmADServicePrincipal

Visar en lista över alla AD-tjänstens huvudnamn i en klientorganisation.

Exempel 2 – Lista AD-tjänstens huvudnamn med växling

PS C:\> Get-AzureRmADServicePrincipal -First 100

Visar de första 100 AD-tjänstens huvudnamn i en klientorganisation.

Exempel 3 – Lista tjänstens huvudnamn efter SPN

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

Listar tjänstens huvudnamn med SPN "36f81fc3-b00f-48cd-8218-3879f51ff39f".

Exempel 4 – Lista tjänstens huvudnamn efter söksträng

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

Visar en lista över alla AD-tjänstens huvudnamn vars visningsnamn börjar med "Web".

Exempel 5 – Lista tjänstens huvudnamn genom rördragning

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

Hämtar AD-programmet med objekt-ID :t "39e64ec6-569b-4030-8e1c-c3c519a05d69" och skickar det till cmdleten Get-AzureRmADServicePrincipal för att visa alla tjänsthuvudnamn för programmet.

Parametrar

-ApplicationId

Program-ID:t för tjänstens huvudnamn.

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

-ApplicationObject

Programobjektet vars huvudnamn för tjänsten hämtas.

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

-DefaultProfile

Autentiseringsuppgifter, konto, klientorganisation och prenumeration som används för kommunikation med Azure

Typ:IAzureContextContainer
Alias:AzureRmContext, AzureCredential
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-DisplayName

Visningsnamnet för tjänstens huvudnamn.

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

-DisplayNameBeginsWith

Söksträngen för tjänstens huvudnamn.

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

-First

Det maximala antalet objekt som ska returneras.

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

-IncludeTotalCount

Rapporterar antalet objekt i datauppsättningen. För närvarande gör den här parametern ingenting.

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

-ObjectId

Objekt-ID för tjänstens huvudnamn.

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

-ServicePrincipalName

SPN för tjänsten.

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

-Skip

Ignorerar de första N-objekten och hämtar sedan de återstående objekten.

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

Indata

String

Guid

PSADApplication

Parametrar: ApplicationObject (ByValue)

Utdata

PSADServicePrincipal