Remove-AzPolicyAssignment

Módulo:

Az.Resources

Esta operación elimina una asignación de directiva, dada su nombre y el ámbito en el que se creó. El ámbito de una asignación de directiva es la parte de su identificador anterior a '/providers/Microsoft.Authorization/policyAssignments/{policyAssignmentName}'.

Sintaxis

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

Esta operación elimina una asignación de directiva, dada su nombre y el ámbito en el que se creó. El ámbito de una asignación de directiva es la parte de su identificador anterior a '/providers/Microsoft.Authorization/policyAssignments/{policyAssignmentName}'.

Ejemplos

Ejemplo 1: Quitar la asignación de directiva por nombre y ámbito

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

El primer comando obtiene un grupo de recursos denominado ResourceGroup11 mediante el cmdlet Get-AzResourceGroup. El comando almacena ese objeto en la variable $ResourceGroup. El segundo comando quita la asignación de directiva denominada PolicyAssignment07 que se asignó en un nivel de grupo de recursos. La propiedad ResourceId de $ResourceGroup identifica el grupo de recursos.

Ejemplo 2: Eliminación de la asignación de directiva por identificador

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

El primer comando obtiene un grupo de recursos denominado ResourceGroup11 y, a continuación, almacena ese objeto en la variable $ResourceGroup. El segundo comando obtiene la asignación de directiva en un nivel de grupo de recursos y, a continuación, la almacena en la variable $PolicyAssignment. La propiedad ResourceId de $ResourceGroup identifica el grupo de recursos. El comando final quita la asignación de directiva que identifica la propiedad ResourceId de $PolicyAssignment.

Ejemplo 3: [Backcompat] Quitar la asignación de directiva por identificador

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

El primer comando obtiene un grupo de recursos denominado ResourceGroup11 y, a continuación, almacena ese objeto en la variable $ResourceGroup. El segundo comando obtiene la asignación de directiva en un nivel de grupo de recursos y, a continuación, la almacena en la variable $PolicyAssignment. La propiedad ResourceId de $ResourceGroup identifica el grupo de recursos. El comando final quita la asignación de directiva que identifica la propiedad ResourceId de $PolicyAssignment.

Parámetros

-BackwardCompatible

Hace que el cmdlet devuelva artefactos mediante la colocación de propiedades específicas de la directiva en un objeto contenedor de propiedades.

Tipo:	SwitchParameter
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-Confirm

Le solicita su confirmación antes de ejecutar el cmdlet.

Tipo:	SwitchParameter
Alias:	cf
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-DefaultProfile

El parámetro DefaultProfile no es funcional. Use el parámetro SubscriptionId cuando esté disponible si ejecuta el cmdlet en otra suscripción.

Tipo:	PSObject
Alias:	AzureRMContext, AzureCredential
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-Force

Cuando $true, omita las indicaciones de confirmación

Tipo:	SwitchParameter
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-Id

Identificador de la asignación de directiva que se va a eliminar. Use el formato '{scope}/providers/Microsoft.Authorization/policyAssignments/{policyAssignmentName}'.

Tipo:	String
Alias:	ResourceId, PolicyAssignmentId
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	True
Aceptar caracteres comodín:	False

-InputObject

Parámetro de identidad Para construir, vea la sección NOTES para las propiedades INPUTOBJECT y crear una tabla hash.

Tipo:	IPolicyIdentity
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	True
Aceptar caracteres comodín:	False

-Name

Nombre de la asignación de directiva que se va a eliminar.

Tipo:	String
Alias:	PolicyAssignmentName
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	True
Aceptar caracteres comodín:	False

-PassThru

Devuelve true cuando el comando se ejecuta correctamente.

Tipo:	SwitchParameter
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-Scope

Ámbito de la asignación de directiva. Los ámbitos válidos son: grupo de administración (formato: '/providers/Microsoft.Management/managementGroups/{managementGroup}'), suscripción (formato: '/subscriptions/{subscriptionId}'), grupo de recursos (formato: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}', o recurso (formato: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/[{parentResourcePath}/]{resourceType}/{resourceName}'

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	True
Aceptar caracteres comodín:	False

-WhatIf

Muestra lo que sucedería si se ejecutara el cmdlet. El cmdlet no se ejecuta.

Tipo:	SwitchParameter
Alias:	wi
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

Entradas

IPolicyIdentity

String

Salidas

Boolean