Compartilhar via

Remove-MsolServicePrincipalCredential

  • Referência
Módulo:
MSOnline

Remove uma chave de credencial de uma entidade de serviço.

Sintaxe

Remove-MsolServicePrincipalCredential
      -ObjectId <Guid>
      -KeyIds <Guid[]>
      [-TenantId <Guid>]
      [<CommonParameters>]
Remove-MsolServicePrincipalCredential
      -KeyIds <Guid[]>
      -ServicePrincipalName <String>
      [-TenantId <Guid>]
      [<CommonParameters>]
Remove-MsolServicePrincipalCredential
      -KeyIds <Guid[]>
      -AppPrincipalId <Guid>
      [-TenantId <Guid>]
      [<CommonParameters>]

Description

O cmdlet Remove-MsolServicePrincipalCredential remove uma chave de credencial de uma entidade de serviço no caso de um comprometimento ou como parte da expiração da substituição de chave de credencial. A entidade de serviço é identificada fornecendo a ID do objeto, a ID do aplicativo ou o SPN (nome da entidade de serviço). A credencial a ser removida é identificada por sua ID de chave.

Exemplos

Exemplo 1: remover uma credencial de uma entidade de serviço

PS C:\> Remove-MsolServicePrincipalCredential -KeyIds @("aaaaaaaa-0b0b-1c1c-2d2d-333333333333") -ServicePrincipalName "MyApp2/myApp.com"

Esse comando remove uma chave de credencial de uma entidade de serviço. Neste exemplo, a ID da chave aaaaaaaa-0b0b-1c1c-2d2d-333333333333 é removida da entidade de serviço associada ao nome da entidade de serviço MyApp2/myApp.com. Para mostrar uma lista de IDs de chave associadas a uma entidade de serviço, use o cmdlet Get-MsolServicePrincipalCredential.

Parâmetros

-AppPrincipalId

Especifica a ID do aplicativo da entidade de serviço da qual remover a credencial.

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

-KeyIds

Especifica uma matriz de IDs exclusivas de chaves de credencial a serem removidas. As principais IDs de uma entidade de serviço podem ser obtidas usando o cmdlet Get-MsolServicePrincipalCredential.

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 da qual remover a credencial.

Tipo:Guid
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 remover a credencial. 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.

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