Partilhar via

Get-MsolServicePrincipalCredential

  • Referência
Módulo:
MSOnline

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

Sintaxe

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 principal de serviço.

Exemplos

Exemplo 1: obter propriedades de credenciais

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

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

Parâmetros

-AppPrincipalId

Especifica o ID da aplicação do principal de serviço para o qual obter credenciais.

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

-ObjectId

Especifica o ID de objeto exclusivo do principal de serviço para o qual obter credenciais.

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

-ReturnKeyValues

Indica se este cmdlet devolve valores de chave.

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

-ServicePrincipalName

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

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

AppName representa o nome da aplicação. O nome do anfitrião representa a autoridade de URI para a 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.ServicePrincipalCredential[]

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

  • Escreva. O tipo de credencial do principal de serviço (Assimétrica/Simétrica/Palavra-passe).
  • Valor. O valor da credencial.
    • Se o tipo de credencial for certificado, representa o certificado codificado de base 64.
    • Se o tipo de credencial for simétrico, representa uma chave AES.
  • KeyGroupId. O identificador reservado para utilização interna.
  • KeyId. O identificador exclusivo da chave.
  • StartDate. A data de início efetiva da utilização das credenciais.
  • EndDate. A data de fim efetiva da utilização das credenciais.
  • Utilização . Especifica se a credencial é utilizada para "assinar" ou "verificar" um token.