Get-MsolServicePrincipalCredential

  • Referência
Módulo:
MSOnline

Obtém credenciais associadas a um diretor de serviço.

Syntax

Get-MsolServicePrincipalCredential
   -ObjectId <Guid>
   -ReturnKeyValues <Boolean>
   [-TenantId <Guid>]
   [<CommonParameters>]
Get-MsolServicePrincipalCredential
   -ReturnKeyValues <Boolean>
   -AppPrincipalId <Guid>
   [-TenantId <Guid>]
   [<CommonParameters>]
Get-MsolServicePrincipalCredential
   -ReturnKeyValues <Boolean>
   -ServicePrincipalName <String>
   [-TenantId <Guid>]
   [<CommonParameters>]

Description

O cmdlet Get-MsolServicePrincipalCredential obtém credenciais associadas a um diretor de serviço.

Exemplos

Exemplo 1: Obter propriedades credenciais

PS C:\> Get-MsolServicePrincipalCredential -ServicePrincipalName "MyApp/myApp.com"

Este comando obtém todas as propriedades credenciais, exceto o valor credencial, que estão associados com o nome principal do serviço (SPN) MyApp/myApp.com. Um SPN deve seguir o formato appClass/hostname, onde o appClass representa a classe de aplicação ("MyApp") e o nome anfitrião representa o nome de anfitrião para a aplicação (myApp.com).

Parâmetros

-AppPrincipalId

Especifica a identificação de aplicação do principal serviço para obter credenciais.

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

-ObjectId

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

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

-ReturnKeyValues

Indica se este cmdlet devolve valores-chave.

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

-ServicePrincipalName

Especifica o nome do principal de serviço a partir do qual obter credenciais. Um SPN deve utilizar um dos seguintes formatos:

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

O AppName representa o nome do pedido. 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.ServicePrincipalCredential[]

Este cmdlet devolve as credenciais que estão associadas a um diretor de serviço. Cada objeto devolvido contém as seguintes informações:

  • Tipo. O tipo de credencial principal de serviço (Assimétrica/Simétrica/Senha).
  • Valor. O valor da credencial.
    • Se o tipo de credencial for certificado, este representa o certificado codificado base 64.
    • Se o tipo de credencial for simétrico, representa uma chave AES.
  • KeyGroupId. O identificador reservado para uso interno.
  • O KeyId. O identificador único da chave.
  • StartDate. A data de início efetiva da utilização da credencial.
  • Fim da date. A data final efetiva da utilização da credencial.
  • Utilização . Especifica se a credencial é usada para "assinar" ou "verificar" um token.