Delen via


Remove-AzPolicyAssignment

Met deze bewerking wordt een beleidstoewijzing verwijderd op basis van de naam en het bereik waarin deze is gemaakt. Het bereik van een beleidstoewijzing is het deel van de id die voorafgaat aan '/providers/Microsoft.Authorization/policyAssignments/{policyAssignmentName}'.

Syntaxis

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

Met deze bewerking wordt een beleidstoewijzing verwijderd op basis van de naam en het bereik waarin deze is gemaakt. Het bereik van een beleidstoewijzing is het deel van de id die voorafgaat aan '/providers/Microsoft.Authorization/policyAssignments/{policyAssignmentName}'.

Voorbeelden

Voorbeeld 1: Beleidstoewijzing verwijderen op naam en bereik

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

Met de eerste opdracht wordt een resourcegroep met de naam ResourceGroup11 ophaalt met behulp van de cmdlet Get-AzResourceGroup. Met de opdracht wordt dat object opgeslagen in de variabele $ResourceGroup. Met de tweede opdracht wordt de beleidstoewijzing met de naam PolicyAssignment07 verwijderd die is toegewezen op resourcegroepniveau. De eigenschap ResourceId van $ResourceGroup identificeert de resourcegroep.

Voorbeeld 2: Beleidstoewijzing verwijderen op id

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

Met de eerste opdracht wordt een resourcegroep met de naam ResourceGroup11 opgehaald en wordt dat object vervolgens opgeslagen in de $ResourceGroup variabele. Met de tweede opdracht wordt de beleidstoewijzing op resourcegroepniveau opgehaald en vervolgens opgeslagen in de variabele $PolicyAssignment. De eigenschap ResourceId van $ResourceGroup identificeert de resourcegroep. Met de laatste opdracht wordt de beleidstoewijzing verwijderd die de eigenschap ResourceId van $PolicyAssignment identificeert.

Voorbeeld 3: [Backcompat] Beleidstoewijzing verwijderen op id

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

Met de eerste opdracht wordt een resourcegroep met de naam ResourceGroup11 opgehaald en wordt dat object vervolgens opgeslagen in de $ResourceGroup variabele. Met de tweede opdracht wordt de beleidstoewijzing op resourcegroepniveau opgehaald en vervolgens opgeslagen in de variabele $PolicyAssignment. De eigenschap ResourceId van $ResourceGroup identificeert de resourcegroep. Met de laatste opdracht wordt de beleidstoewijzing verwijderd die de eigenschap ResourceId van $PolicyAssignment identificeert.

Parameters

-BackwardCompatible

Zorgt ervoor dat cmdlet artefacten retourneert met behulp van verouderde indeling waarbij beleidsspecifieke eigenschappen in een eigenschapsverzamelingsobject worden geplaatst.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Confirm

Hiermee wordt u gevraagd om bevestiging voordat u de cmdlet uitvoert.

Type:SwitchParameter
Aliassen:cf
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-DefaultProfile

De parameter DefaultProfile is niet functioneel. Gebruik de parameter SubscriptionId indien beschikbaar als u de cmdlet uitvoert voor een ander abonnement.

Type:PSObject
Aliassen:AzureRMContext, AzureCredential
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Force

Sla bevestigingsprompts over wanneer $true

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Id

De id van de beleidstoewijzing die moet worden verwijderd. Gebruik de indeling {scope}/providers/Microsoft.Authorization/policyAssignments/{policyAssignmentName}.

Type:String
Aliassen:ResourceId, PolicyAssignmentId
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-InputObject

Identity Parameter To construct, zie DE SECTIE NOTES voor INPUTOBJECT-eigenschappen en maak een hash-tabel.

Type:IPolicyIdentity
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-Name

De naam van de beleidstoewijzing die u wilt verwijderen.

Type:String
Aliassen:PolicyAssignmentName
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-PassThru

Retourneert waar wanneer de opdracht slaagt

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Scope

Het bereik van de beleidstoewijzing. Geldige bereiken zijn: beheergroep (indeling: '/providers/Microsoft.Management/managementGroups/{managementGroup}'), abonnement (indeling: '/subscriptions/{subscriptionId}'), resourcegroep (indeling: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}', of resource (indeling: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/[{parentResourcePath}/]{resourceType}/{resourceName}'

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-WhatIf

Hiermee wordt weergegeven wat er zou gebeuren als u de cmdlet uitvoert. De cmdlet wordt niet uitgevoerd.

Type:SwitchParameter
Aliassen:wi
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

Invoerwaarden

IPolicyIdentity

String

Uitvoerwaarden

Boolean