Partilhar via

Get-MsolServicePrincipal

  • Referência
Módulo:
MSOnline

Obtém principais 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 um principal de serviço ou uma lista de principais de serviço do Azure Active Directory.

Exemplos

Exemplo 1: apresentar todos os principais de serviço

PS C:\> Get-MsolServicePrincipal

Este comando apresenta todos os principais de serviço existentes no inquilino da organização.

Exemplo 2: obter principais de serviço com um nome

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

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

Exemplo 3: Obter um principal de serviço

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

Este comando obtém um principal de serviço que tem um ID de principal de aplicação específico.

Parâmetros

-All

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

Tipo:SwitchParameter
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-AppPrincipalId

Especifica o ID de aplicação exclusivo do principal de serviço a obter.

Tipo:Guid
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-MaxResults

Especifica o número máximo de resultados devolvidos por este cmdlet. O valor predefinido é 500.

Tipo:Int32
Position:Named
Default value:500
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-ObjectId

Especifica o ID de objeto exclusivo do principal de serviço a obter.

Tipo:Guid
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-SearchString

Especifica uma cadeia para corresponder aos nomes dos principais de serviço.

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-ServicePrincipalName

Especifica o nome do principal de serviço ou principais de serviço a obter. Um SPN tem de utilizar um dos seguintes formatos:

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

AppName representa o nome da aplicação e o nome do anfitrião representa a autoridade de URI da aplicação.

Tipo:String
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-TenantId

Especifica o ID exclusivo do inquilino no qual efetuar a operação. O valor predefinido é o inquilino do utilizador atual. Este parâmetro aplica-se apenas aos utilizadores parceiros.

Tipo:Guid
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

Saídas

Microsoft.Online.Administration.ServicePrincipal[]

Este cmdlet devolve um principal de serviço ou uma lista de principais de serviço do Azure Active Directory. Cada principal de serviço contém as seguintes informações:

  • ObjectId. O identificador exclusivo do principal de serviço.
  • AppPrincipalId. O identificador da aplicação do principal de serviço.
  • DisplayName. O nome amigável do principal de serviço.
  • ServicePrincipalName. A lista de nomes de principais de serviço (SPNs) associados ao principal de serviço.
  • AccountEnabled. O valor que indica se a conta está ativada.