Compartilhar via

Remove-AzureRmADServicePrincipal

  • Referência
Módulo:
AzureRM.Resources

Exclui a entidade de serviço do Microsoft Entra.

Aviso

O módulo PowerShell do AzureRM 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 do Az PowerShell para garantir o suporte e as atualizações contínuas.

Embora o módulo AzureRM ainda possa funcionar, ele não tem suporte ou será mantido, 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.

Sintaxe

Remove-AzureRmADServicePrincipal
      -ObjectId <Guid>
      [-PassThru]
      [-Force]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-AzureRmADServicePrincipal
      -ApplicationId <Guid>
      [-PassThru]
      [-Force]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-AzureRmADServicePrincipal
      -ServicePrincipalName <String>
      [-PassThru]
      [-Force]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-AzureRmADServicePrincipal
      -DisplayName <String>
      [-PassThru]
      [-Force]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-AzureRmADServicePrincipal
      -InputObject <PSADServicePrincipal>
      [-PassThru]
      [-Force]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-AzureRmADServicePrincipal
      -ApplicationObject <PSADApplication>
      [-PassThru]
      [-Force]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

Exclui a entidade de serviço do Microsoft Entra.

Exemplos

Exemplo 1 – Remover uma entidade de serviço por ID de objeto

PS C:\> Remove-AzureRmADServicePrincipal -ObjectId 61b5d8ea-fdc6-40a2-8d5b-ad447c678d45

Remove a entidade de serviço com a ID de objeto '61b5d8ea-fdc6-40a2-8d5b-ad447c678d45'.

Exemplo 2 – Remover uma entidade de serviço por ID do aplicativo

PS C:\> Remove-AzureRmADServicePrincipal -ApplicationId 00001111-aaaa-2222-bbbb-3333cccc4444

Remove a entidade de serviço com a ID do aplicativo '00001111-aaaa-2222-bbbb-3333cccc4444'.

Exemplo 3 – Remover uma entidade de serviço por SPN

PS C:\> Remove-AzureRmADServicePrincipal -ServicePrincipalName MyServicePrincipal

Remover a entidade de serviço com o nome da entidade de serviço "MyServicePrincipal"

Exemplo 4 – Remover uma entidade de serviço por tubulação

PS C:\> Get-AzureRmADServicePrincipal -ObjectId 61b5d8ea-fdc6-40a2-8d5b-ad447c678d45 | Remove-AzureRmADServicePrincipal

Obtém a entidade de serviço com a ID de objeto '61b5d8ea-fdc6-40a2-8d5b-ad447c678d45' e a canaliza para o cmdlet Remove-AzureRmADServicePrincipal para remover essa entidade de serviço.

Exemplo 5 – Remover uma entidade de serviço canalizando um aplicativo

PS C:\> Get-AzureRmApplication -ApplicationId 00001111-aaaa-2222-bbbb-3333cccc4444 | Remove-AzureRmADServicePrincipal

Obtém o aplicativo com a ID do aplicativo '00001111-aaaa-2222-bbbb-3333cccc4444' e canaliza isso para o cmdlet Remove-AzureRmADServicePrincipal para remover a entidade de serviço associada a esse aplicativo.

Parâmetros

-ApplicationId

A ID do aplicativo da entidade de serviço.

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

-ApplicationObject

O objeto de aplicativo cuja entidade de serviço está sendo removida.

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

-Confirm

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

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

-DefaultProfile

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

Tipo:IAzureContextContainer
Aliases:AzureRmContext, AzureCredential
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DisplayName

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

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

-Force

Alterne para excluir a entidade de serviço sem uma confirmação.

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

-InputObject

O objeto da entidade de serviço.

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

-ObjectId

A ID do objeto da entidade de serviço a ser excluída.

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

-PassThru

Se especificado, retorna a entidade de serviço excluída.

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

-ServicePrincipalName

O nome da entidade de serviço.

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

-WhatIf

Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

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

Entradas

Guid

String

PSADServicePrincipal

Parâmetros: InputObject (ByValue)

PSADApplication

Parâmetros: ApplicationObject (ByValue)

Saídas

PSADServicePrincipal

Observações

Palavras-chave: azure, azurerm, arm, recurso, gerenciamento, gerente, recurso, grupo, modelo, implantação