Remove-AzureRmADSpCredential
Remove uma credencial de uma entidade de serviço.
Aviso
O módulo do PowerShell do AzureRM foi oficialmente preterido em 29 de fevereiro de 2024. Os usuários são aconselhados a migrar do AzureRM para o módulo do Az PowerShell para garantir o suporte e as atualizações contínuas.
Embora o módulo AzureRM ainda possa funcionar, ele não é mais mantido ou suportado, colocando qualquer uso contínuo a critério e risco do usuário. Consulte nossos recursos de migração para obter diretrizes 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 de substituição de chave de credencial. A entidade de serviço é identificada fornecendo a ID do objeto ou o SPN (nome da entidade de serviço). A credencial a ser removida é identificada por sua 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 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
Alterne para excluir credencial 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. Os Ids de chave para uma entidade de serviço podem ser obtidos 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 foi 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 de entidade 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
Mostra o que aconteceria se o cmdlet fosse executado. 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
Parâmetros: ServicePrincipalObject (ByValue)