Remove-AzureRmADSpCredential

  • Referência
Módulo:
AzureRM.Resources

Remove uma credencial de uma entidade de serviço.

Aviso

O módulo AzureRM PowerShell foi oficialmente preterido a partir de 29 de fevereiro de 2024. Os usuários são aconselhados a migrar do AzureRM para o módulo Az PowerShell para garantir suporte e atualizações contínuos.

Embora o módulo AzureRM ainda possa funcionar, ele não é mais mantido ou suportado, colocando qualquer uso continuado a critério e risco do usuário. Consulte nossos recursos de migração para obter orientação sobre a transição para o módulo Az.

Syntax

Remove-AzureRmADSpCredential
      -ObjectId <Guid>
      [-KeyId <Guid>]
      [-PassThru]
      [-Force]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-AzureRmADSpCredential
      -ServicePrincipalName <String>
      [-KeyId <Guid>]
      [-PassThru]
      [-Force]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-AzureRmADSpCredential
      -DisplayName <String>
      [-PassThru]
      [-Force]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-AzureRmADSpCredential
      -ServicePrincipalObject <PSADServicePrincipal>
      [-KeyId <Guid>]
      [-PassThru]
      [-Force]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

O cmdlet Remove-AzureRmADSpCredential pode ser usado para remover uma chave de credencial de uma entidade de serviço no caso de um comprometimento ou como parte da expiração da substituição da chave de credencial. A entidade de serviço é identificada fornecendo o ID do objeto ou o SPN (nome da entidade de serviço). A credencial a ser removida é identificada por seu ID de chave se uma credencial individual for removida ou com uma opção 'Todos' para excluir todas as credenciais associadas à entidade de serviço.

Exemplos

Exemplo 1 - Remover uma credencial específica de uma entidade de serviço

PS C:\> Remove-AzureRmADSpCredential -ObjectId 7663d3fb-6f86-4352-9e6d-cf9d50d5ee82 -KeyId 9044423a-60a3-45ac-9ab1-09534157ebb

Remove a credencial com id de chave '9044423a-60a3-45ac-9ab1-09534157ebb' da entidade de serviço com id de objeto '7663d3fb-6f86-4352-9e6d-cf9d50d5ee82'.

Exemplo 2 - Remover todas as credenciais de uma entidade de serviço

PS C:\> Remove-AzureRmADSpCredential -ServicePrincipalName http://test123

Remove todas as credenciais da entidade de serviço com o SPN "http://test123".

Exemplo 3 - Remover todas as credenciais de uma entidade de serviço usando tubulação

PS C:\> Get-AzureRmADServicePrincipal -ObjectId 7663d3fb-6f86-4352-9e6d-cf9d50d5ee82 | Remove-AzureRmADSpCredential

Obtém a entidade de serviço com a id de objeto '7663d3fb-6f86-4352-9e6d-cf9d50d5ee82' e canaliza isso para o cmdlet Remove-AzureRmADSpCredential para remover todas as credenciais dessa entidade de serviço.

Parâmetros

-Confirm

Solicita a sua confirmação antes de executar o cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

As credenciais, a conta, o locatário e a assinatura usados para comunicação com o azure

Type:IAzureContextContainer
Aliases:AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DisplayName

O nome para exibição da entidade de serviço.

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

-Force

Mude para excluir credenciais sem uma confirmação.

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

-KeyId

Especifica a chave de credencial a ser removida. As Ids de chave para uma entidade de serviço podem ser obtidas usando o cmdlet Get-AzureRmADSpCredential.

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

-ObjectId

A id do objeto da entidade de serviço da qual remover as credenciais.

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

-PassThru

Especificar isso retornará true se o comando tiver sido bem-sucedido.

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

-ServicePrincipalName

O nome (SPN) da entidade de serviço da qual remover as credenciais.

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

-ServicePrincipalObject

O objeto principal de serviço do qual remover as credenciais.

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

-WhatIf

Apresenta o que aconteceria mediante a execução do cmdlet. O cmdlet não é executado.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Entradas

Guid

String

PSADServicePrincipal

Parâmetros: ServicePrincipalObject (ByValue)

Saídas

Boolean