Share via

Remove-MsolServicePrincipalCredential

  • Referência
Módulo:
MSOnline

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

Syntax

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. O objeto de serviço é identificado ao fornecer a identificação do objeto, a identificação do aplicativo ou o nome do objeto de serviço (SPN). A credencial a ser removida é identificada por sua identificação de chave.

Exemplos

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

PS C:\> Remove-MsolServicePrincipalCredential -KeyIds @("19805a93-e9dd-4c63-8afd-88ed91f33546") -ServicePrincipalName "MyApp2/myApp.com"

Esse comando remove uma chave de credencial de uma entidade de serviço. Neste exemplo, a ID da chave 19805a93-e9dd-4c63-8afd-88ed91f33546 é 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.

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

-KeyIds

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

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

Type:Guid
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 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.

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