Compartilhar via

Get-MsolServicePrincipalCredential

  • Referência
Módulo:
MSOnline

Obtém credenciais associadas a uma entidade 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 uma entidade de serviço.

Exemplos

Exemplo 1: Obter propriedades de credencial

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

Esse comando obtém todas as propriedades de credencial, exceto o valor da credencial, que estão associadas ao myApp/myApp.com do nome da entidade de serviço (SPN). Um SPN deve seguir o formato appClass/hostname, em que appClass representa a classe de aplicativo ("MyApp") e o nome do host representa o nome do host do aplicativo (myApp.com).

Parâmetros

-AppPrincipalId

Especifica a ID do aplicativo da entidade de serviço para a qual obter credenciais.

Tipo:Guid
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-ObjectId

Especifica a ID de objeto exclusiva da entidade de serviço para a qual obter credenciais.

Tipo:Guid
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-ReturnKeyValues

Indica se esse cmdlet retorna valores de chave.

Tipo:Boolean
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-ServicePrincipalName

Especifica o nome da entidade de serviço da qual obter credenciais. Um SPN deve usar um dos seguintes formatos:

  • appName
  • appName/hostname
  • uma URL válida

AppName representa o nome do aplicativo. O nome do host representa a autoridade de URI para o aplicativo.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga: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.

Tipo:Guid
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

Saídas

Microsoft.Online.Administration.ServicePrincipalCredential[]

Esse cmdlet retorna as credenciais associadas a uma entidade de serviço. Cada objeto retornado contém as seguintes informações:

  • Digite. O tipo de credencial da entidade de serviço (assimétrica/simétrica/senha).
  • Value. O valor da credencial.
    • Se o tipo de credencial for certificado, este representa o certificado codificado em base 64.
    • Se o tipo de credencial for simétrico, ele representará uma chave AES.
  • KeyGroupId. O identificador reservado para uso interno.
  • KeyId. O identificador exclusivo da chave.
  • Startdate. A data de início efetiva do uso da credencial.
  • Enddate. A data de término efetiva do uso da credencial.
  • Uso. Especifica se a credencial é usada para "assinar" ou "verificar" um token.