Get-EntraApplicationServiceEndpoint
Recupere o ponto de extremidade de serviço de um aplicativo.
Sintaxe
Default (Default)
Get-EntraApplicationServiceEndpoint
-ServicePrincipalId <String>
[-All]
[-Top <Int32>]
[-Property <String[]>]
[<CommonParameters>]
Description
O Get-EntraApplicationServiceEndpoint cmdlet recupera os pontos de extremidade de serviço de um aplicativo.
A entidade do ponto de extremidade de serviço contém informações de descoberta de serviço. A propriedade serviceEndpoints da entidade Application é do tipo ServiceEndpoint.
Outros serviços podem usar as informações armazenadas na entidade ServiceEndpoint para localizar esse serviço e seus pontos de extremidade endereçáveis.
Exemplos
Exemplo 1: recuperar o ponto de extremidade do serviço de aplicativo por ID
Connect-Entra -Scopes 'Application.Read.All'
$servicePrincipal = Get-EntraServicePrincipal -Filter "DisplayName eq 'Contoso Helpdesk App'"
Get-EntraApplicationServiceEndpoint -ServicePrincipalId $servicePrincipal.Id
Este exemplo demonstra como recuperar o ponto de extremidade de serviço do aplicativo especificado por meio do parâmetro ID do objeto.
-ServicePrincipalIdO parâmetro especifica a ID de um objeto de aplicativo em Microsoft Entra ID.
Exemplo 2: Obter todos os pontos de extremidade de serviço
Connect-Entra -Scopes 'Application.Read.All'
$servicePrincipal = Get-EntraServicePrincipal -Filter "DisplayName eq 'Contoso Helpdesk App'"
Get-EntraApplicationServiceEndpoint -ServicePrincipalId $servicePrincipal.Id -All
Este exemplo demonstra como recuperar todos os pontos de extremidade de serviço de um aplicativo especificado.
-ServicePrincipalIdO parâmetro especifica a ID de um objeto de aplicativo em Microsoft Entra ID.
Exemplo 3: Obter os cinco principais pontos de extremidade de serviço
Connect-Entra -Scopes 'Application.Read.All'
$servicePrincipal = Get-EntraServicePrincipal -Filter "DisplayName eq 'Contoso Helpdesk App'"
Get-EntraApplicationServiceEndpoint -ServicePrincipalId $servicePrincipal.Id -Top 5
Este exemplo demonstra como recuperar cinco pontos de extremidade de serviço de um aplicativo especificado. Você pode usar -Limit como um alias para -Top.
-ServicePrincipalIdO parâmetro especifica a ID de um objeto de aplicativo em Microsoft Entra ID.
Parâmetros
-All
Retornar todos os pontos de extremidade de serviço.
Propriedades do parâmetro
| Tipo: | System.Management.Automation.SwitchParameter |
| Valor padrão: | False |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Property
Especifica as propriedades a serem retornadas
Propriedades do parâmetro
| Tipo: | System.String[] |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
| Aliases: | Select |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-ServicePrincipalId
Especifica a ID do objeto do aplicativo para o qual o ponto de extremidade de serviço é recuperado.
Propriedades do parâmetro
| Tipo: | System.String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
| Aliases: | IdentificadorDeObjeto |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | True |
| Valor do pipeline: | True |
| Valor do pipeline pelo nome da propriedade: | True |
| Valor dos argumentos restantes: | False |
-Top
Especifica o número máximo de resultados retornados. O padrão é 100.
Propriedades do parâmetro
| Tipo: | System.Int32 |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
| Aliases: | Limit |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | True |
| Valor do pipeline pelo nome da propriedade: | True |
| Valor dos argumentos restantes: | False |
CommonParameters
Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.
Entradas
System.String
System.Nullable'1[[System.Boolean, mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089]] System.Nullable'1[[System.Int32, mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089]]