Share via

Get-MsolServicePrincipalCredential

  • Referência
Módulo:
MSOnline

Obtém credenciais associadas a uma entidade 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 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 nome da entidade de serviço (SPN) MyApp/myApp.com. 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.

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

-ObjectId

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

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

-ReturnKeyValues

Indica se esse cmdlet retorna valores de chave.

Type:Boolean
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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 do aplicativo.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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.

Type:Guid
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters: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.