Get-ServicePrincipal
Esse cmdlet só está disponível no serviço baseado em nuvem.
Use o cmdlet Get-ServicePrincipal para exibir informações sobre entidades de serviço em sua organização baseada em nuvem.
Para saber mais sobre os conjuntos de parâmetros na seção Sintaxe, abaixo, consulte Exchange cmdlet syntax.
Sintaxe
Default (Default)
Get-ServicePrincipal
[[-Identity] <ServicePrincipalIdParameter>]
[-Organization <OrganizationIdParameter>]
[<CommonParameters>]
Description
Existem entidades de serviço no Microsoft Entra ID para definir o que os aplicativos podem fazer, quem pode acessar os aplicativos e quais recursos os aplicativos podem acessar. No Exchange Online, as entidades de serviço são referências às entidades de serviço no Microsoft Entra ID. Para atribuir funções de RBAC (controle de acesso baseado em função) do Exchange Online a entidades de serviço no Microsoft Entra ID, use as referências da entidade de serviço no Exchange Online. Os cmdlets *-ServicePrincipal no PowerShell do Exchange Online permitem exibir, criar e remover essas referências da entidade de serviço.
Para obter mais informações, consulte Objetos de entidade de serviço e aplicativo no Microsoft Entra ID.
Para executar esse cmdlet, você precisa ter permissões. Embora este artigo liste todos os parâmetros do cmdlet, talvez você não tenha acesso a alguns parâmetros se eles não estiverem incluídos nas permissões atribuídas a você. Para localizar as permissões necessárias para executar qualquer cmdlet ou parâmetro em sua organização, confira Find the permissions required to run any Exchange cmdlet.
Exemplos
Exemplo 1
Get-ServicePrincipal
Este exemplo retorna uma lista resumida de todas as entidades de serviço em uma organização.
Exemplo 2
Get-ServicePrincipal -Identity ca73fffa-cedb-4b84-860f-d7fb8aa8a6c1 | Format-List
Este exemplo retorna informações detalhadas sobre a entidade de serviço com o valor ObjectId ca73fffa-cedb-4b84-860f-d7fb8aa8a6c1.
Parâmetros
-Identity
Aplicável: Exchange Online, Segurança & Conformidade, Complemento de segurança integrado para caixas de correio locais
O parâmetro Identity especifica a entidade de serviço que você deseja exibir. Você pode usar qualquer valor que identifique exclusivamente a entidade de serviço. Por exemplo:
- Nome
- DN (nome diferenciado)
- GUID
- AppId
- ObjectId
Cuidado: O valor $null ou um valor inexistente para o parâmetro Identity retorna todos os objetos como se você tivesse executado o comando Get- sem o parâmetro Identity. Verifique se todas as listas de valores para o parâmetro Identity são precisas e não contêm valores de $null inexistentes.
Propriedades do parâmetro
| Tipo: | ServicePrincipalIdParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | 0 |
| Obrigatório: | False |
| Valor do pipeline: | True |
| Valor do pipeline pelo nome da propriedade: | True |
| Valor dos argumentos restantes: | False |
-Organization
Aplicável: Exchange Online, Segurança & Conformidade, Complemento de segurança integrado para caixas de correio locais
Esse parâmetro está reservado para uso interno da Microsoft.
Propriedades do parâmetro
| Tipo: | OrganizationIdParameter |
| Valor padrão: | None |
| 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 |
CommonParameters
Este cmdlet dá suporte aos parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, confira about_CommonParameters.