Delen via

Get-AzureRmADServicePrincipal

  • Referentie
Module:
AzureRM.Resources

Filtert active directory-service-principals.

Waarschuwing

De AzureRM PowerShell-module is vanaf 29 februari 2024 officieel afgeschaft. Gebruikers wordt aangeraden om van AzureRM naar de Az PowerShell-module te migreren om ondersteuning en updates te garanderen.

Hoewel de AzureRM-module nog steeds kan functioneren, wordt deze niet meer onderhouden of ondersteund, waardoor het gebruik naar eigen goeddunken en risico van de gebruiker blijft bestaan. Raadpleeg onze migratiebronnen voor hulp bij de overgang naar de Az-module.

Syntaxis

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

Filtert active directory-service-principals.

Voorbeelden

Voorbeeld 1: AD-service-principals vermelden

PS C:\> Get-AzureRmADServicePrincipal

Een lijst met alle AD-service-principals in een tenant.

Voorbeeld 2: AD-service-principals vermelden met paging

PS C:\> Get-AzureRmADServicePrincipal -First 100

Een lijst met de eerste 100 AD-service-principals in een tenant.

Voorbeeld 3: service-principals per SPN vermelden

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

Een lijst met service-principals met de SPN '36f81fc3-b00f-48cd-8218-3879f51ff39f'.

Voorbeeld 4: service-principals weergeven op zoekreeks

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

Een lijst met alle AD-service-principals waarvan de weergavenaam begint met 'Web'.

Voorbeeld 5: service-principals weergeven door te piping

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

Haalt de AD-toepassing op met object-id '39e64ec6-569b-4030-8e1c-c3c519a05d69' en pijpt deze naar de Get-AzureRmADServicePrincipal-cmdlet om alle service-principals voor die toepassing weer te geven.

Parameters

-ApplicationId

De toepassings-id van de service-principal.

Type:Guid
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-ApplicationObject

Het toepassingsobject waarvan de service-principal wordt opgehaald.

Type:PSADApplication
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-DefaultProfile

De referenties, het account, de tenant en het abonnement dat wordt gebruikt voor communicatie met Azure

Type:IAzureContextContainer
Aliassen:AzureRmContext, AzureCredential
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-DisplayName

De weergavenaam van de service-principal.

Type:String
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-DisplayNameBeginsWith

De zoekreeks van de service-principal.

Type:String
Aliassen:SearchString
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-First

Het maximum aantal objecten dat moet worden geretourneerd.

Type:UInt64
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-IncludeTotalCount

Hiermee wordt het aantal objecten in de gegevensset gerapporteerd. Op dit moment doet deze parameter niets.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-ObjectId

Object-id van de service-principal.

Type:Guid
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-ServicePrincipalName

SPN van de service.

Type:String
Aliassen:SPN
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-Skip

Negeert de eerste N-objecten en haalt vervolgens de resterende objecten op.

Type:UInt64
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

Invoerwaarden

String

Guid

PSADApplication

Parameters: ApplicationObject (ByValue)

Uitvoerwaarden

PSADServicePrincipal