Get-AzureRmADServicePrincipal
Filtra entidades de serviço do Ative Directory.
Aviso
O módulo AzureRM 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.
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
Filtra entidades de serviço do Ative Directory.
Exemplos
Exemplo 1 - Listar entidades de serviço do AD
PS C:\> Get-AzureRmADServicePrincipalLista 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 100Lista 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-3879f51ff39fLista 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-AzureRmADServicePrincipalObté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.
| Type: | Guid |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-ApplicationObject
O objeto de aplicativo cuja entidade de serviço está sendo recuperada.
| Type: | PSADApplication |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-DefaultProfile
As credenciais, a conta, o locatário e a assinatura usados para comunicação com o azure
| Type: | IAzureContextContainer |
| Aliases: | AzureRmContext, AzureCredential |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DisplayName
O nome de exibição da entidade de serviço.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-DisplayNameBeginsWith
A cadeia de caracteres de pesquisa da entidade de serviço.
| Type: | String |
| Aliases: | SearchString |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-First
O número máximo de objetos a serem retornados.
| Type: | UInt64 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-IncludeTotalCount
Relata o número de objetos no conjunto de dados. Atualmente, este parâmetro não faz nada.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ObjectId
ID do objeto da entidade de serviço.
| Type: | Guid |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-ServicePrincipalName
SPN do serviço.
| Type: | String |
| Aliases: | SPN |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Skip
Ignora os primeiros objetos N e, em seguida, obtém os objetos restantes.
| Type: | UInt64 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Entradas
Parâmetros: ApplicationObject (ByValue)