Compartilhar via

Get-MsolServicePrincipal

  • Referência
Módulo:
MSOnline

Obtém entidades de serviço do Azure Active Directory.

Sintaxe

Get-MsolServicePrincipal
   [-SearchString <String>]
   [-MaxResults <Int32>]
   [-TenantId <Guid>]
   [<CommonParameters>]
Get-MsolServicePrincipal
   -ObjectId <Guid>
   [-TenantId <Guid>]
   [<CommonParameters>]
Get-MsolServicePrincipal
   -AppPrincipalId <Guid>
   [-TenantId <Guid>]
   [<CommonParameters>]
Get-MsolServicePrincipal
   -ServicePrincipalName <String>
   [-TenantId <Guid>]
   [<CommonParameters>]
Get-MsolServicePrincipal
   [-SearchString <String>]
   [-All]
   [-TenantId <Guid>]
   [<CommonParameters>]

Description

O cmdlet Get-MsolServicePrincipal obtém uma entidade de serviço ou uma lista de entidades de serviço do Azure Active Directory.

Exemplos

Exemplo 1: exibir todas as entidades de serviço

PS C:\> Get-MsolServicePrincipal

Esse comando exibe todas as entidades de serviço existentes no locatário da organização.

Exemplo 2: Obter entidades de serviço usando um nome

PS C:\> Get-MsolServicePrincipal -ServicePrincipalName "MyApp"

Esse comando obtém todas as entidades de serviço existentes que têm um nome de entidade de serviço que começa com MyApp. Essa é uma correspondência exata da parte appClass do nome da entidade de serviço até a barra de avanço.

Exemplo 3: Obter uma entidade de serviço

PS C:\> Get-MsolServicePrincipal -AppPrincipalId 5e964d2f-e384-4292-ae55-dd24c89cc53b

Esse comando obtém uma entidade de serviço que tem uma ID de entidade de aplicativo específica.

Parâmetros

-All

Indica que este cmdlet retorna todos os resultados. Não especifique junto com o parâmetro MaxResults .

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

-AppPrincipalId

Especifica a ID exclusiva do aplicativo da entidade de serviço a ser obtido.

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

-MaxResults

Especifica o número máximo de resultados retornados por este cmdlet. O valor padrão é 500.

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

-ObjectId

Especifica a ID de objeto exclusiva da entidade de serviço a ser obtido.

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

-SearchString

Especifica uma cadeia de caracteres para corresponder aos nomes da entidade de serviço.

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

-ServicePrincipalName

Especifica o nome da entidade de serviço ou das entidades de serviço a serem obtidos. Um SPN deve usar um dos seguintes formatos:

  • appName
  • appName/hostname
  • uma URL válida

AppName representa o nome do aplicativo e o nome do host representa a autoridade de URI do aplicativo.

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

-TenantId

Especifica a ID exclusiva do locatário no qual executar a operação. O valor padrão é o locatário do usuário atual. Esse parâmetro se aplica somente a usuários parceiros.

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

Saídas

Microsoft.Online.Administration.ServicePrincipal[]

Esse cmdlet retorna uma entidade de serviço ou uma lista de entidades de serviço do Azure Active Directory. Cada entidade de serviço contém a seguinte informação:

  • Objectid. O identificador exclusivo da entidade de serviço.
  • AppPrincipalId. O identificador de aplicativo da entidade de serviço.
  • DisplayName. O nome amigável da entidade de serviço.
  • Serviceprincipalname. A lista de SPNs (nomes de entidade de serviço) associada à entidade de serviço.
  • AccountEnabled. O valor que indica se a conta está habilitada.