Partilhar via

Get-AzureRmADServicePrincipal

  • Referência
Módulo:
AzureRM.Resources

Filtra entidades de serviço do Ative Directory.

Aviso

O módulo AzureRM do PowerShell foi oficialmente preterido a partir de 29 de fevereiro de 2024. Os usuários são aconselhados a migrar do AzureRM para o módulo Az PowerShell para garantir suporte e atualizações contínuos.

Embora o módulo AzureRM ainda possa funcionar, ele não é mais mantido ou suportado, colocando qualquer uso continuado a critério e risco do usuário. Consulte nossos recursos de migração para obter orientação sobre a transição para o módulo Az.

Sintaxe

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

Filtra entidades de serviço do Ative Directory.

Exemplos

Exemplo 1 - Listar entidades de serviço do AD

PS C:\> Get-AzureRmADServicePrincipal

Lista todas as entidades de serviço do AD em um locatário.

Exemplo 2 - Listar entidades de serviço do AD usando paginação

PS C:\> Get-AzureRmADServicePrincipal -First 100

Lista as primeiras 100 entidades de serviço do AD em um locatário.

Exemplo 3 - Listar entidades de serviço por SPN

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

Lista entidades de serviço com o SPN '36f81fc3-b00f-48cd-8218-3879f51ff39f'.

Exemplo 4 - Listar entidades de serviço por cadeia de caracteres de pesquisa

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

Lista todas as entidades de serviço do AD cujo nome para exibição começa com "Web".

Exemplo 5 - Listar entidades de serviço por tubulação

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

Obtém o aplicativo AD com a id de objeto '39e64ec6-569b-4030-8e1c-c3c519a05d69' e o canaliza para o cmdlet Get-AzureRmADServicePrincipal para listar todas as entidades de serviço desse aplicativo.

Parâmetros

-ApplicationId

A ID do aplicativo principal de serviço.

Tipo:Guid
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-ApplicationObject

O objeto de aplicativo cuja entidade de serviço está sendo recuperada.

Tipo:PSADApplication
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-DefaultProfile

As credenciais, a conta, o locatário e a assinatura usados para comunicação com o azure

Tipo:IAzureContextContainer
Aliases:AzureRmContext, AzureCredential
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-DisplayName

O nome de exibição da entidade de serviço.

Tipo:String
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-DisplayNameBeginsWith

A cadeia de caracteres de pesquisa da entidade de serviço.

Tipo:String
Aliases:SearchString
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-First

O número máximo de objetos a serem retornados.

Tipo:UInt64
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-IncludeTotalCount

Relata o número de objetos no conjunto de dados. Atualmente, este parâmetro não faz nada.

Tipo:SwitchParameter
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-ObjectId

ID do objeto da entidade de serviço.

Tipo:Guid
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-ServicePrincipalName

SPN do serviço.

Tipo:String
Aliases:SPN
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-Skip

Ignora os primeiros objetos N e, em seguida, obtém os objetos restantes.

Tipo:UInt64
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

Entradas

String

Guid

PSADApplication

Parâmetros: ApplicationObject (ByValue)

Saídas

PSADServicePrincipal