Get-EntraServicePrincipal

Módulo:: Microsoft.Entra.Applications Module v1.3

Recebe um diretor de serviço.

Sintaxe

GetQuery (Predefinição)

Get-EntraServicePrincipal

    [-Top <Int32>]
    [-All]
    [-Filter <String>]
    [-Property <String[]>]
    [-AssignmentRequired <Boolean>]
    [-ApplicationType <String>]
    [<CommonParameters>]

GetVague

Get-EntraServicePrincipal

    [-SearchString <String>]
    [-All]
    [-Property <String[]>]
    [-AssignmentRequired <Boolean>]
    [-ApplicationType <String>]
    [<CommonParameters>]

GetById

Get-EntraServicePrincipal

    -ServicePrincipalId <String>
    [-All]
    [-Property <String[]>]
    [<CommonParameters>]

Descrição

O Get-EntraServicePrincipal cmdlet recebe um princípio de serviço no Microsoft Entra ID.

Exemplos

Exemplo 1: Recuperar todos os principais de serviço do diretório

Connect-Entra -Scopes 'Application.Read.All'
Get-EntraServicePrincipal

ObjectId                             AppId                                DisplayName
--------                             -----                                -----------
bbbbbbbb-1111-2222-3333-cccccccccccc 00001111-aaaa-2222-bbbb-3333cccc4444 Demo App
aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb 22223333-cccc-4444-dddd-5555eeee6666 Demo Two App
dddddddd-3333-4444-5555-eeeeeeeeeeee 33334444-dddd-5555-eeee-6666ffff7777 ProjectWorkManagement

Este exemplo recupera todos os principais de serviço do diretório.

Exemplo 2: Recuperar um principal de serviço por ServicePrincipalId

Connect-Entra -Scopes 'Application.Read.All'
$servicePrincipal = Get-EntraServicePrincipal -Filter "displayName eq 'Helpdesk Application'"
Get-EntraServicePrincipal -ServicePrincipalId $servicePrincipal.Id

DisplayName                         Id                                   AppId                                SignInAudience      ServicePrincipalType
-----------                         --                                   -----                                --------------      --------------------
Helpdesk Application                aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb 00001111-aaaa-2222-bbbb-3333cccc4444 AzureADMultipleOrgs Application

Este comando recupera um principal de serviço específico.

-ServicePrincipalId O parâmetro especifica o ID de um principal de serviço.

Exemplo 3: Recuperar todos os principais de serviço a partir do diretório

Connect-Entra -Scopes 'Application.Read.All'
Get-EntraServicePrincipal -All

DisplayName                         Id                                   AppId                                SignInAudience      ServicePrincipalType
-----------                         --                                   -----                                --------------      --------------------
Helpdesk Application                aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb 00001111-aaaa-2222-bbbb-3333cccc4444 AzureADMultipleOrgs Application
Microsoft Device Management Checkin bbbbbbbb-1111-2222-3333-cccccccccccc 11112222-bbbb-3333-cccc-4444dddd5555 AzureADMultipleOrgs Application
ProvisioningPowerBi                 cccccccc-2222-3333-4444-dddddddddddd 22223333-cccc-4444-dddd-5555eeee6666                     Application

Este exemplo recupera todos os principais de serviço do diretório.

Exemplo 4: Recuperar os dois principais principais do serviço a partir do diretório

Connect-Entra -Scopes 'Application.Read.All'
Get-EntraServicePrincipal -Top 2

DisplayName                         Id                                   AppId                                SignInAudience      ServicePrincipalType
-----------                         --                                   -----                                --------------      --------------------
Helpdesk Application                aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb 00001111-aaaa-2222-bbbb-3333cccc4444 AzureADMultipleOrgs Application
Microsoft Device Management Checkin bbbbbbbb-1111-2222-3333-cccccccccccc 11112222-bbbb-3333-cccc-4444dddd5555 AzureADMultipleOrgs Application

Este comando recupera os dois principais principais de serviço do diretório. Você pode usar -Limit como um alias para -Top.

Exemplo 5: Obtenha um principal de serviço por nome de exibição

Connect-Entra -Scopes 'Application.Read.All'
Get-EntraServicePrincipal -Filter "displayName eq 'Helpdesk Application'"

DisplayName                         Id                                   AppId                                SignInAudience      ServicePrincipalType
-----------                         --                                   -----                                --------------      --------------------
Helpdesk Application                aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb 00001111-aaaa-2222-bbbb-3333cccc4444 AzureADMultipleOrgs Application

Este exemplo recebe um princípio de serviço pelo seu nome de visualização.

Exemplo 6: Recuperar uma lista de todos os principais de serviço, que tem um nome de exibição que contém "Aplicação de Helpdesk"

Connect-Entra -Scopes 'Application.Read.All'
Get-EntraServicePrincipal -SearchString 'Helpdesk Application'

DisplayName                         Id                                   AppId                                SignInAudience      ServicePrincipalType
-----------                         --                                   -----                                --------------      --------------------
Helpdesk Application                aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb 00001111-aaaa-2222-bbbb-3333cccc4444 AzureADMultipleOrgs Application

Este exemplo recebe uma lista do principal de serviço, que tem o nome de exibição especificado.

Exemplo 7: Recuperar todas as aplicações empresariais

Connect-Entra -Scopes 'Application.Read.All'
Get-EntraServicePrincipal -Filter "tags/Any(x: x eq 'WindowsAzureActiveDirectoryIntegratedApp')"

DisplayName         Id                                   AppId                                SignInAudience         ServicePrincipalType
-----------         --                                   -----                                --------------         --------------------
Enterprise App1     00001111-aaaa-2222-bbbb-3333cccc4444 33334444-dddd-5555-eeee-6666ffff7777                         Application
Enterprise App2     11112222-bbbb-3333-cccc-4444dddd5555 22223333-cccc-4444-dddd-5555eeee6666 AzureADMultipleOrgs    Application

Este exemplo demonstra como recuperar todas as aplicações empresariais.

Exemplo 8: Recuperar todas as aplicações proxy da aplicação

Connect-Entra -Scopes 'Application.Read.All'
Get-EntraServicePrincipal -Filter "tags/Any(x: x eq 'WindowsAzureActiveDirectoryOnPremApp')"

DisplayName         Id                                   AppId                                SignInAudience         ServicePrincipalType
-----------         --                                   -----                                --------------         --------------------
App proxy 1     00001111-aaaa-2222-bbbb-3333cccc4444 33334444-dddd-5555-eeee-6666ffff7777                         Application
App proxy 2     11112222-bbbb-3333-cccc-4444dddd5555 22223333-cccc-4444-dddd-5555eeee6666 AzureADMultipleOrgs    Application

Este exemplo demonstra como recuperar todas as aplicações proxy de aplicações.

Exemplo 9: Recuperar todas as aplicações desativadas

Connect-Entra -Scopes 'Application.Read.All'
Get-EntraServicePrincipal -Filter "accountEnabled eq false"

DisplayName         Id                                   AppId                                SignInAudience         ServicePrincipalType
-----------         --                                   -----                                --------------         --------------------
Disabled App1     00001111-aaaa-2222-bbbb-3333cccc4444 33334444-dddd-5555-eeee-6666ffff7777                         Application

Este exemplo demonstra como recuperar todas as aplicações desativadas.

Exemplo 10: Recuperar todas as aplicações de Acesso Seguro Global

Connect-Entra -Scopes 'Application.Read.All'
Get-EntraServicePrincipal -Filter "tags/Any(x: x eq 'PrivateAccessNonWebApplication') or tags/Any(x: x eq 'NetworkAccessManagedApplication')"

DisplayName         Id                                   AppId                                SignInAudience         ServicePrincipalType
-----------         --                                   -----                                --------------         --------------------
Global secure access app     00001111-aaaa-2222-bbbb-3333cccc4444 33334444-dddd-5555-eeee-6666ffff7777                         Application

Este exemplo demonstra como recuperar todas as aplicações de acesso seguro global.

Exemplo 11: Liste todas as aplicações sem atribuição de utilizador

Connect-Entra -Scopes 'Application.Read.All'
Get-EntraServicePrincipal -All | Where-Object {$_.appRoleAssignmentRequired -ne 'true'}

DisplayName                     Id                                   AppId                                SignInAudience         ServicePrincipalType
-----------                     --                                   -----                                --------------         --------------------
App without user assignment     00001111-aaaa-2222-bbbb-3333cccc4444 33334444-dddd-5555-eeee-6666ffff7777                         Application

Este exemplo demonstra como recuperar todas as aplicações sem atribuição de utilizador.

Exemplo 12: Liste todos os detalhes da aplicação SAML

Connect-Entra -Scopes 'Application.Read.All'
$servicePrincipal = Get-EntraServicePrincipal -Filter "PreferredSingleSignOnMode eq 'saml'"
$servicePrincipal | Select-Object Id, DisplayName, AccountEnabled, AppId, PreferredSingleSignOnMode, AppRoleAssignmentRequired, SignInAudience, NotificationEmailAddresses, PreferredTokenSigningKeyEndDateTime, PreferredTokenSigningKeyValid, ReplyUrls,LoginUrl, LogoutUrl | Format-Table -AutoSize

Id                                   DisplayName                           AccountEnabled AppId                                PreferredSingleSignOnMode AppRoleAssignmentRequired SignInAudience NotificationEmailAddresses
--                                   -----------                           -------------- -----                                ------------------------- ------------------------- -------------- --------------
00001111-aaaa-2222-bbbb-3333cccc4444 SAML App                             True            33334444-dddd-5555-eeee-6666ffff7777 saml                              True                    AzureADMyOrg   {admin@Contoso}

Este exemplo demonstra como recuperar todos os detalhes da aplicação em SAML.

Exemplo 13: Listar funções para a aplicação de principal de serviço

Connect-Entra -Scopes 'Application.Read.All'
$servicePrincipal = Get-EntraServicePrincipal -SearchString 'Contoso Helpdesk Application'
$servicePrincipal.AppRoles | Format-Table -AutoSize

AllowedMemberTypes    Description        DisplayName       Id                                   IsEnabled  Origin       Value
------------------    -----------        -----------       --                                   ---------  ------       -----
{User, Application}   General All        General All       gggggggg-6666-7777-8888-hhhhhhhhhhhh  True       Application  Survey.Read
{Application}         General App Only   General Apponly   hhhhhhhh-7777-8888-9999-iiiiiiiiiiii  True       Application  Task.Write
{User}                General role       General           bbbbbbbb-1111-2222-3333-cccccccccccc  True       Application  General

Este exemplo mostra como pode obter funções de aplicação para um principal de serviço.

Exemplo 14: Listar candidaturas (principais de serviços) fora do meu inquilino

Connect-Entra -Scopes 'Application.Read.All'
$tenantId = Get-EntraContext | Select-Object -ExpandProperty TenantId
$servicePrincipals = Get-EntraServicePrincipal -All -Property AppOwnerOrganizationId, Id, DisplayName, AppId
$externalServicePrincipals = $servicePrincipals | Where-Object { $_.AppOwnerOrganizationId -ne $tenantId }
$externalServicePrincipals | Select-Object DisplayName, Id, AppId, AppOwnerOrganizationId | Format-Table -AutoSize

DisplayName                                             Id                                   AppId                                AppOwnerOrganizationId
-----------                                             --                                   -----                                ----------------------
Azure MFA StrongAuthenticationService                   aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb 00001111-aaaa-2222-bbbb-3333cccc4444 f8cdef31-a31e-4b4a-93e4-5f571e91255a
M365 Label Analytics                                    bbbbbbbb-1111-2222-3333-cccccccccccc 11112222-bbbb-3333-cccc-4444dddd5555 f8cdef31-a31e-4b4a-93e4-5f571e91255a
PowerApps-Advisor                                       cccccccc-2222-3333-4444-dddddddddddd 22223333-cccc-4444-dddd-5555eeee6666 f8cdef31-a31e-4b4a-93e4-5f571e91255a

Este exemplo mostra como podes recuperar candidaturas (principais de serviço) fora do meu inquilino.

Exemplo 15: Recuperar princípios de serviço com atribuição de utilizador necessária

Connect-Entra -Scopes 'Application.Read.All'
Get-EntraServicePrincipal -AssignmentRequired $true

DisplayName                Id                                   AppId                                SignInAudience      ServicePrincipalType
-----------                --                                   -----                                --------------      --------------------
Restricted App             aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb 00001111-aaaa-2222-bbbb-3333cccc4444 AzureADMyOrg        Application

Este exemplo recupera todos os principais de serviço onde é necessária atribuição de utilizador para aceder à aplicação.

Exemplo 16: Recuperar Aplicações Empresariais usando o parâmetro ApplicationType

Connect-Entra -Scopes 'Application.Read.All'
Get-EntraServicePrincipal -ApplicationType EnterpriseApps

DisplayName         Id                                   AppId                                SignInAudience         ServicePrincipalType
-----------         --                                   -----                                --------------         --------------------
Enterprise App1     00001111-aaaa-2222-bbbb-3333cccc4444 33334444-dddd-5555-eeee-6666ffff7777                         Application
Enterprise App2     11112222-bbbb-3333-cccc-4444dddd5555 22223333-cccc-4444-dddd-5555eeee6666 AzureADMultipleOrgs    Application

Este exemplo demonstra como recuperar todas as aplicações empresariais usando o parâmetro ApplicationType. Os valores válidos são: AppProxyApps, EnterpriseApps, Managed Identity, MicrosoftApps.

Exemplo 17: Recuperar Identidades Geridas

Connect-Entra -Scopes 'Application.Read.All'
Get-EntraServicePrincipal -ApplicationType ManagedIdentity

DisplayName         Id                                   AppId                                SignInAudience         ServicePrincipalType
-----------         --                                   -----                                --------------         --------------------
MyVM-Identity       00001111-aaaa-2222-bbbb-3333cccc4444 33334444-dddd-5555-eeee-6666ffff7777                         ManagedIdentity

Este exemplo recupera todas as identidades geridas.

Exemplo 18: Combinar os filtros AssignmentRequired e ApplicationType

Connect-Entra -Scopes 'Application.Read.All'
Get-EntraServicePrincipal -AssignmentRequired $true -ApplicationType EnterpriseApps

DisplayName                Id                                   AppId                                SignInAudience      ServicePrincipalType
-----------                --                                   -----                                --------------      --------------------
Secured Enterprise App     aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb 00001111-aaaa-2222-bbbb-3333cccc4444 AzureADMyOrg        Application

Este exemplo demonstra como combinar os parâmetros AssignmentRequired e ApplicationType para filtrar aplicações empresariais que requerem atribuição de utilizador.

Parâmetros

-All

Liste todas as páginas.

Propriedades dos parâmetros

Tipo:	System.Management.Automation.SwitchParameter
Valor predefinido:	False
Suporta carateres universais:	False
NãoMostrar:	False

Conjuntos de parâmetros

(All)

Posto:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	False
Valor dos restantes argumentos:	False

-ApplicationType

Filtrar por tipo de candidatura. Os valores válidos são:

AppProxyApps: Aplicações proxy de aplicação
EnterpriseApps: Aplicações empresariais
ManagedIdentity: Principais de serviços de identidade gerida
MicrosoftApps: Aplicações de primeira parte da Microsoft

Propriedades dos parâmetros

Tipo:	System.String
Valor predefinido:	None
Suporta carateres universais:	False
NãoMostrar:	False

Conjuntos de parâmetros

GetQuery

Posto:	Named
Obrigatório:	False
Valor do pipeline:	True
Valor do pipeline por nome de propriedade:	True
Valor dos restantes argumentos:	False

GetVague

Posto:	Named
Obrigatório:	False
Valor do pipeline:	True
Valor do pipeline por nome de propriedade:	True
Valor dos restantes argumentos:	False

-AssignmentRequired

Filtre por se é necessária atribuição de utilizador para aceder à aplicação. Quando definido como $true, devolve apenas as entidades de serviço em que é necessária a atribuição de utilizadores. Quando definido para $false, retorna apenas os principais de serviço onde a atribuição de utilizador não é necessária.

Propriedades dos parâmetros

Tipo:	System.Boolean
Valor predefinido:	None
Suporta carateres universais:	False
NãoMostrar:	False

Conjuntos de parâmetros

GetQuery

Posto:	Named
Obrigatório:	False
Valor do pipeline:	True
Valor do pipeline por nome de propriedade:	True
Valor dos restantes argumentos:	False

GetVague

Posto:	Named
Obrigatório:	False
Valor do pipeline:	True
Valor do pipeline por nome de propriedade:	True
Valor dos restantes argumentos:	False

-Filter

Especifica uma instrução de filtro OData v4.0. Este parâmetro controla quais os objetos que são devolvidos.

Propriedades dos parâmetros

Tipo:	System.String
Valor predefinido:	None
Suporta carateres universais:	False
NãoMostrar:	False

Conjuntos de parâmetros

GetQuery

Posto:	Named
Obrigatório:	False
Valor do pipeline:	True
Valor do pipeline por nome de propriedade:	True
Valor dos restantes argumentos:	False

-Property

Especifica propriedades a devolver.

Propriedades dos parâmetros

Tipo:	System.String[]
Valor predefinido:	None
Suporta carateres universais:	False
NãoMostrar:	False
Aliases:	Select

Conjuntos de parâmetros

(All)

Posto:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	False
Valor dos restantes argumentos:	False

-SearchString

Especifica uma cadeia de pesquisa.

Propriedades dos parâmetros

Tipo:	System.String
Valor predefinido:	None
Suporta carateres universais:	False
NãoMostrar:	False

Conjuntos de parâmetros

GetVague

Posto:	Named
Obrigatório:	False
Valor do pipeline:	True
Valor do pipeline por nome de propriedade:	True
Valor dos restantes argumentos:	False

-ServicePrincipalId

Especifica o ID de um principal de serviço no Microsoft Entra ID.

Propriedades dos parâmetros

Tipo:	System.String
Valor predefinido:	None
Suporta carateres universais:	False
NãoMostrar:	False
Aliases:	IdentificadorDoObjeto

Conjuntos de parâmetros

GetById

Posto:	Named
Obrigatório:	True
Valor do pipeline:	True
Valor do pipeline por nome de propriedade:	True
Valor dos restantes argumentos:	False

-Top

Especifica o número máximo de registos a devolver.

Propriedades dos parâmetros

Tipo:	System.Int32
Valor predefinido:	None
Suporta carateres universais:	False
NãoMostrar:	False
Aliases:	Limit

Conjuntos de parâmetros

GetQuery

Posto:	Named
Obrigatório:	False
Valor do pipeline:	True
Valor do pipeline por nome de propriedade:	True
Valor dos restantes argumentos:	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.

Comentários

Esta página foi útil?

Get-EntraServicePrincipal

Sintaxe

GetQuery (Predefinição)

GetVague

GetById

Descrição

Exemplos

Exemplo 1: Recuperar todos os principais de serviço do diretório

Exemplo 2: Recuperar um principal de serviço por ServicePrincipalId

Exemplo 3: Recuperar todos os principais de serviço a partir do diretório

Exemplo 4: Recuperar os dois principais principais do serviço a partir do diretório

Exemplo 5: Obtenha um principal de serviço por nome de exibição

Exemplo 6: Recuperar uma lista de todos os principais de serviço, que tem um nome de exibição que contém "Aplicação de Helpdesk"

Exemplo 7: Recuperar todas as aplicações empresariais

Exemplo 8: Recuperar todas as aplicações proxy da aplicação

Exemplo 9: Recuperar todas as aplicações desativadas

Exemplo 10: Recuperar todas as aplicações de Acesso Seguro Global

Exemplo 11: Liste todas as aplicações sem atribuição de utilizador

Exemplo 12: Liste todos os detalhes da aplicação SAML

Exemplo 13: Listar funções para a aplicação de principal de serviço

Exemplo 14: Listar candidaturas (principais de serviços) fora do meu inquilino

Exemplo 15: Recuperar princípios de serviço com atribuição de utilizador necessária

Exemplo 16: Recuperar Aplicações Empresariais usando o parâmetro ApplicationType

Exemplo 17: Recuperar Identidades Geridas

Exemplo 18: Combinar os filtros AssignmentRequired e ApplicationType

Parâmetros

-All

Propriedades dos parâmetros

Conjuntos de parâmetros

-ApplicationType

Propriedades dos parâmetros

Conjuntos de parâmetros

-AssignmentRequired

Propriedades dos parâmetros

Conjuntos de parâmetros

-Filter

Propriedades dos parâmetros

Conjuntos de parâmetros

-Property

Propriedades dos parâmetros

Conjuntos de parâmetros

-SearchString

Propriedades dos parâmetros

Conjuntos de parâmetros

-ServicePrincipalId

Propriedades dos parâmetros

Conjuntos de parâmetros

-Top

Propriedades dos parâmetros

Conjuntos de parâmetros

CommonParameters

Ligações Relacionadas

Comentários