Share via

Get-MsolServicePrincipal

  • Referência
Módulo:
MSOnline

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

Syntax

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 o MyApp. Essa é uma correspondência exata da parte appClass do nome da entidade de serviço até a barra de encaminhamento.

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 esse cmdlet retorna todos os resultados. Não especifique junto com o parâmetro MaxResults .

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-AppPrincipalId

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

Type:Guid
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-MaxResults

Especifica o número máximo de resultados que esse cmdlet retorna. O valor padrão é 500.

Type:Int32
Position:Named
Default value:500
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ObjectId

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

Type:Guid
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-SearchString

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ServicePrincipalName

Especifica o nome da entidade de serviço ou 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.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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.

Type:Guid
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters: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 do aplicativo da entidade de serviço.
  • DisplayName. O nome amigável da entidade de serviço.
  • Serviceprincipalname. A lista de SPNs (nomes da entidade de serviço) associada à entidade de serviço.
  • AccountEnabled. O valor que indica se a conta está habilitada.