Get-AzADServicePrincipal

Referência

Módulo:: Az.Resources

Lista entidades de entidades de serviço ou obter entidade de entidades de serviço por chave

Sintaxe

Get-AzADServicePrincipal
   [-Select <String[]>]
   [-Count]
   [-Filter <String>]
   [-Orderby <String[]>]
   [-Search <String>]
   [-ConsistencyLevel <String>]
   [-First <UInt64>]
   [-Skip <UInt64>]
   [-AppendSelected]
   [-DefaultProfile <PSObject>]
   [-CountVariable <String>]
   [<CommonParameters>]

Get-AzADServicePrincipal
   -ObjectId <String>
   [-Select <String[]>]
   [-First <UInt64>]
   [-Skip <UInt64>]
   [-AppendSelected]
   [-DefaultProfile <PSObject>]
   [<CommonParameters>]

Get-AzADServicePrincipal
   [-Select <String[]>]
   -DisplayNameBeginsWith <String>
   [-First <UInt64>]
   [-Skip <UInt64>]
   [-AppendSelected]
   [-DefaultProfile <PSObject>]
   [<CommonParameters>]

Get-AzADServicePrincipal
   [-Select <String[]>]
   -DisplayName <String>
   [-First <UInt64>]
   [-Skip <UInt64>]
   [-AppendSelected]
   [-DefaultProfile <PSObject>]
   [<CommonParameters>]

Get-AzADServicePrincipal
   [-Select <String[]>]
   -ApplicationId <Guid>
   [-First <UInt64>]
   [-Skip <UInt64>]
   [-AppendSelected]
   [-DefaultProfile <PSObject>]
   [<CommonParameters>]

Get-AzADServicePrincipal
   [-Select <String[]>]
   -ApplicationObject <IMicrosoftGraphApplication>
   [-First <UInt64>]
   [-Skip <UInt64>]
   [-AppendSelected]
   [-DefaultProfile <PSObject>]
   [<CommonParameters>]

Get-AzADServicePrincipal
   [-Select <String[]>]
   -ServicePrincipalName <String>
   [-First <UInt64>]
   [-Skip <UInt64>]
   [-AppendSelected]
   [-DefaultProfile <PSObject>]
   [<CommonParameters>]

Description

Lista entidades de entidades de serviço ou obter entidade de entidades de serviço por chave

Exemplos

Exemplo 1: Obter a entidade de serviço pelo nome de exibição

Get-AzADServicePrincipal -DisplayName $name

Obter a entidade de serviço pelo nome de exibição

Exemplo 2: a pesquisa pelo nome de exibição da entidade de serviço começa com

Get-AzADServicePrincipal -DisplayNameStartsWith $prefix

A pesquisa pelo nome de exibição da entidade de serviço começa com

Exemplo 3: Listar entidades de serviço

Get-AzADServicePrincipal -First 10 -Select Tags -AppendSelected

Liste as 10 primeiras entidades de serviço e acrescente a propriedade 'Tags' após as propriedades padrão: 'DisplayName', 'Id', 'DeletedDateTime', 'ServicePrincipalNames', 'AppId'

Exemplo 4: Obter a entidade de serviço por ID do aplicativo

Get-AzADServicePrincipal -ApplicationId $appId

Obter a entidade de serviço por ID do aplicativo

Exemplo 5: Obter a entidade de serviço por entrada de pipeline

Get-AzADApplication -DisplayName $name | Get-AzADServicePrincipal

Obter a entidade de serviço por entrada de pipeline

Exemplo 6: Obter a entidade de serviço com filtro

Get-AzADServicePrincipal -Filter "startsWith(DisplayName,'some-name')"

Obter a entidade de serviço com filtro

Exemplo 7: Atribuir OdataCount a uma variável

Get-AzADServicePrincipal -First 10 -ConsistencyLevel eventual -Count -CountVariable 'result'
$result

Atribuir OdataCount a uma variável

Parâmetros

-AppendSelected

Anexar propriedades selecionadas com propriedades padrão quando essa opção estiver ativada, só funcionará com o parâmetro '-Select'.

Tipo:	SwitchParameter
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-ApplicationId

ID do aplicativo de serviceprincipal

Tipo:	Guid
Aliases:	AppId
Cargo:	Named
Valor padrão:	None
Obrigatório:	True
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-ApplicationObject

O objeto da entidade de serviço pode ser usado como entrada de pipeline.

Tipo:	IMicrosoftGraphApplication
Cargo:	Named
Valor padrão:	None
Obrigatório:	True
Aceitar a entrada de pipeline:	True
Aceitar caracteres curinga:	False

-ConsistencyLevel

Indica o nível de consistência solicitado. URL da documentação: https://developer.microsoft.com/en-us/office/blogs/microsoft-graph-advanced-queries-for-directory-objects-are-now-generally-available/

Tipo:	String
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-Count

Incluir contagem de itens

Tipo:	SwitchParameter
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-CountVariable

Especifica uma contagem do número total de itens em uma coleção. Por padrão, essa variável será definida no escopo global.

Tipo:	String
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-DefaultProfile

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

Tipo:	PSObject
Aliases:	AzContext, AzureRmContext, AzureCredential
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-DisplayName

nome de exibição serviceprincipal

Tipo:	String
Cargo:	Named
Valor padrão:	None
Obrigatório:	True
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-DisplayNameBeginsWith

o nome de exibição serviceprincipal começa com

Tipo:	String
Aliases:	DisplayNameStartsWith, SearchString
Cargo:	Named
Valor padrão:	None
Obrigatório:	True
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-Filter

Filtrar itens por valores de propriedade, para obter mais detalhes sobre a consulta de filtro, consulte: https://learn.microsoft.com/en-us/graph/filter-query-parameter

Tipo:	String
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-First

Obtém apenas os primeiros objetos 'n'.

Tipo:	UInt64
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-ObjectId

key: id de servicePrincipal

Tipo:	String
Aliases:	ServicePrincipalId, Id
Cargo:	Named
Valor padrão:	None
Obrigatório:	True
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-Orderby

Itens de pedido por valores de propriedade

Tipo:	String[]
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-Search

Pesquisar itens por frases de pesquisa

Tipo:	String
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-Select

Selecionar propriedades a serem retornadas

Tipo:	String[]
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-ServicePrincipalName

nome serviceprincipal

Tipo:	String
Aliases:	SPN
Cargo:	Named
Valor padrão:	None
Obrigatório:	True
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-Skip

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

Tipo:	UInt64
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

Entradas

IMicrosoftGraphApplication

Saídas

IMicrosoftGraphServicePrincipal

Compartilhar via