Remove-AzureRmADServicePrincipal

Referência

Módulo:: AzureRM.Resources

Exclui a entidade de serviço do Microsoft Entra.

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-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 do objeto '61b5d8ea-fdc6-40a2-8d5b-ad447c678d45'.

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

PS C:\> Remove-AzureRmADServicePrincipal -ApplicationId 9263469e-d328-4321-8646-3e3e75d20e76

Remove a entidade de serviço com a ID do aplicativo '9263469e-d328-4321-8646-3e3e75d20e76'.

Exemplo 3 - Remover uma entidade de serviço pelo SPN

PS C:\> Remove-AzureRmADServicePrincipal -ServicePrincipalName MyServicePrincipal

Remova 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 do objeto '61b5d8ea-fdc6-40a2-8d5b-ad447c678d45' e canaliza isso 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 9263469e-d328-4321-8646-3e3e75d20e76 | Remove-AzureRmADServicePrincipal

Obtém o aplicativo com a ID do aplicativo '9263469e-d328-4321-8646-3e3e75d20e76' 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 principal de serviço.

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

-ApplicationObject

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

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

-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 a entidade de serviço sem uma confirmação.

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

-InputObject

O objeto principal do serviço.

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

-ObjectId

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

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

-PassThru

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

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

-ServicePrincipalName

O nome da entidade de serviço.

Type:	String
Aliases:	SPN
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: InputObject (ByValue)

PSADApplication

Parâmetros: ApplicationObject (ByValue)

Saídas