Get-MsolServicePrincipal

  • Referência
Módulo:
MSOnline

Recebe diretores de serviço da Azure Ative 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 recebe um diretor de serviço ou uma lista de diretores de serviço da Azure Ative Directory.

Exemplos

Exemplo 1: Mostrar todos os princípios de serviço

PS C:\> Get-MsolServicePrincipal

Este comando exibe todos os diretores de serviço existentes no inquilino da organização.

Exemplo 2: Obter princípios de serviço usando um nome

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

Este comando recebe todos os principais de serviço existentes que têm um nome principal de serviço que começa com o MyApp. Esta é uma correspondência exata da parte appClass do nome principal do serviço até ao corte dianteiro.

Exemplo 3: Obter um diretor de serviço

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

Este comando recebe um principal de serviço que tem uma identificação principal de aplicação específica.

Parâmetros

-All

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

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

-AppPrincipalId

Especifica o ID de aplicação único do principal de serviço para obter.

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 este cmdlet devolve. O valor predefinido é 500.

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

-ObjectId

Especifica o ID do objeto único do principal de serviço para obter.

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

-SearchString

Especifica uma cadeia para combinar os nomes principais do serviço.

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

-ServicePrincipalName

Especifica o nome do diretor de serviço ou dos principais de serviço para obter. Um SPN deve utilizar um dos seguintes formatos:

  • appName
  • appName/hostname
  • um URL válido

O AppName representa o nome do pedido e o nome anfitrião representa a autoridade URI para o pedido.

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

-TenantId

Especifica a identificação única do inquilino para realizar a operação. O valor predefinido é o inquilino do utilizador atual. Este parâmetro aplica-se apenas aos utilizadores parceiros.

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

Saídas

Microsoft.Online.Administration.ServicePrincipal[]

Este cmdlet devolve um diretor de serviço ou uma lista de diretores de serviço da Azure Ative Directory. Cada responsável de serviço contém as seguintes informações:

  • ObjectId. O identificador único do chefe de serviço.
  • AppPrincipalId. O identificador de aplicação do diretor de serviço.
  • DisplayName. O nome amigável do diretor de serviço.
  • Nome Do ServiçoPrincipal. A lista de nomes principais de serviço (SPNs) associados ao principal serviço.
  • Responsável. O valor indicando se a conta está ativada.