Remove-AzPolicyAssignment

Referência

Módulo:: Az.Resources

Esta operação exclui uma atribuição de política, dado seu nome e o escopo em que foi criada. O escopo de uma atribuição de política é a parte de sua ID que precede '/providers/Microsoft.Authorization/policyAssignments/{policyAssignmentName}'.

Syntax

Remove-AzPolicyAssignment
      -Name <String>
      [-Scope <String>]
      [-Force]
      [-BackwardCompatible]
      [-DefaultProfile <PSObject>]
      [-PassThru]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Remove-AzPolicyAssignment
      -Id <String>
      [-Force]
      [-BackwardCompatible]
      [-DefaultProfile <PSObject>]
      [-PassThru]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Remove-AzPolicyAssignment
      -InputObject <IPolicyIdentity>
      [-Force]
      [-BackwardCompatible]
      [-DefaultProfile <PSObject>]
      [-PassThru]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

Exemplos

Exemplo 1: Remover atribuição de política por nome e escopo

$ResourceGroup = Get-AzResourceGroup -Name 'ResourceGroup11'
Remove-AzPolicyAssignment -Name 'PolicyAssignment07' -Scope $ResourceGroup.ResourceId -Force

O primeiro comando obtém um grupo de recursos chamado ResourceGroup11 usando o cmdlet Get-AzResourceGroup. O comando armazena esse objeto na variável $ResourceGroup. O segundo comando remove a atribuição de política chamada PolicyAssignment07 que foi atribuída em um nível de grupo de recursos. A propriedade ResourceId de $ResourceGroup identifica o grupo de recursos.

Exemplo 2: Remover atribuição de política por ID

$ResourceGroup = Get-AzResourceGroup -Name 'ResourceGroup11' 
$PolicyAssignment = Get-AzPolicyAssignment -Name 'PolicyAssignment07' -Scope $ResourceGroup.ResourceId
Remove-AzPolicyAssignment -Id $PolicyAssignment.ResourceId -Confirm:$false

O primeiro comando obtém um grupo de recursos chamado ResourceGroup11 e, em seguida, armazena esse objeto na variável $ResourceGroup. O segundo comando obtém a atribuição de política em um nível de grupo de recursos e, em seguida, armazena-a na variável $PolicyAssignment. A propriedade ResourceId de $ResourceGroup identifica o grupo de recursos. O comando final remove a atribuição de política que a propriedade ResourceId de $PolicyAssignment identifica.

Exemplo 3: [Backcompat] Remover atribuição de política por ID

$ResourceGroup = Get-AzResourceGroup -Name 'ResourceGroup11' 
$PolicyAssignment = Get-AzPolicyAssignment -Name 'PolicyAssignment07' -Scope $ResourceGroup.ResourceId
Remove-AzPolicyAssignment -Id $PolicyAssignment.ResourceId -Confirm:$false -BackwardCompatible
True

Parâmetros

-BackwardCompatible

Faz com que o cmdlet retorne artefatos usando o formato herdado colocando propriedades específicas da política em um objeto de pacote de propriedades.

Tipo:	SwitchParameter
Position:	Named
valor predefinido:	None
Necessário:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Confirm

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

Tipo:	SwitchParameter
Aliases:	cf
Position:	Named
valor predefinido:	None
Necessário:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DefaultProfile

O parâmetro DefaultProfile não é funcional. Use o parâmetro SubscriptionId quando disponível se estiver executando o cmdlet em uma assinatura diferente.

Tipo:	PSObject
Aliases:	AzureRMContext, AzureCredential
Position:	Named
valor predefinido:	None
Necessário:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Force

Quando $true, ignore os prompts de confirmação

Tipo:	SwitchParameter
Position:	Named
valor predefinido:	None
Necessário:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Id

A ID da atribuição de política a ser excluída. Use o formato '{scope}/providers/Microsoft.Authorization/policyAssignments/{policyAssignmentName}'.

Tipo:	String
Aliases:	ResourceId, PolicyAssignmentId
Position:	Named
valor predefinido:	None
Necessário:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-InputObject

Parâmetro de identidade Para construir, consulte a seção NOTAS para propriedades INPUTOBJECT e crie uma tabela de hash.

Tipo:	IPolicyIdentity
Position:	Named
valor predefinido:	None
Necessário:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-Name

O nome da atribuição de política a ser excluída.

Tipo:	String
Aliases:	PolicyAssignmentName
Position:	Named
valor predefinido:	None
Necessário:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-PassThru

Retorna true quando o comando é bem-sucedido

Tipo:	SwitchParameter
Position:	Named
valor predefinido:	None
Necessário:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Scope

O escopo da atribuição de política. Os escopos válidos são: grupo de gerenciamento (formato: '/providers/Microsoft.Management/managementGroups/{managementGroup}'), assinatura (formato: '/subscriptions/{subscriptionId}'), grupo de recursos (formato: '/subscriptionId}/resourceGroups/{resourceGroupName}', ou recurso (formato: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/[{parentResourcePath}/]{resourceType}/{resourceName}'

Tipo:	String
Position:	Named
valor predefinido:	None
Necessário:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-WhatIf

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

Tipo:	SwitchParameter
Aliases:	wi
Position:	Named
valor predefinido:	None
Necessário:	False
Accept pipeline input:	False
Accept wildcard characters:	False

Entradas

IPolicyIdentity

String

Saídas

Boolean

Partilhar via