Remove-AzPolicyAssignment
Tato operace odstraní přiřazení zásady s názvem a oborem, ve který byl vytvořen. Rozsah přiřazení zásady je součástí id před názvem /providers/Microsoft.Authorization/policyAssignments/{policyAssignmentName}.
Syntaxe
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
Tato operace odstraní přiřazení zásady s názvem a oborem, ve který byl vytvořen. Rozsah přiřazení zásady je součástí id před názvem /providers/Microsoft.Authorization/policyAssignments/{policyAssignmentName}.
Příklady
Příklad 1: Odebrání přiřazení zásad podle názvu a oboru
$ResourceGroup = Get-AzResourceGroup -Name 'ResourceGroup11'
Remove-AzPolicyAssignment -Name 'PolicyAssignment07' -Scope $ResourceGroup.ResourceId -Force
První příkaz získá skupinu prostředků s názvem ResourceGroup11 pomocí rutiny Get-AzResourceGroup. Příkaz uloží tento objekt do proměnné $ResourceGroup. Druhý příkaz odebere přiřazení zásady s názvem PolicyAssignment07, které bylo přiřazeno na úrovni skupiny prostředků. Vlastnost ResourceId $ResourceGroup identifikuje skupinu prostředků.
Příklad 2: Odebrání přiřazení zásad podle ID
$ResourceGroup = Get-AzResourceGroup -Name 'ResourceGroup11'
$PolicyAssignment = Get-AzPolicyAssignment -Name 'PolicyAssignment07' -Scope $ResourceGroup.ResourceId
Remove-AzPolicyAssignment -Id $PolicyAssignment.ResourceId -Confirm:$false
První příkaz získá skupinu prostředků s názvem ResourceGroup11 a pak tento objekt uloží do $ResourceGroup proměnné. Druhý příkaz získá přiřazení zásady na úrovni skupiny prostředků a pak ho uloží do proměnné $PolicyAssignment. Vlastnost ResourceId $ResourceGroup identifikuje skupinu prostředků. Poslední příkaz odebere přiřazení zásady, které ResourceId vlastnost $PolicyAssignment identifikuje.
Příklad 3: [Backcompat] Odebrání přiřazení zásad podle ID
$ResourceGroup = Get-AzResourceGroup -Name 'ResourceGroup11'
$PolicyAssignment = Get-AzPolicyAssignment -Name 'PolicyAssignment07' -Scope $ResourceGroup.ResourceId
Remove-AzPolicyAssignment -Id $PolicyAssignment.ResourceId -Confirm:$false -BackwardCompatible
True
První příkaz získá skupinu prostředků s názvem ResourceGroup11 a pak tento objekt uloží do $ResourceGroup proměnné. Druhý příkaz získá přiřazení zásady na úrovni skupiny prostředků a pak ho uloží do proměnné $PolicyAssignment. Vlastnost ResourceId $ResourceGroup identifikuje skupinu prostředků. Poslední příkaz odebere přiřazení zásady, které ResourceId vlastnost $PolicyAssignment identifikuje.
Parametry
-BackwardCompatible
Způsobí, že rutina vrátí artefakty pomocí staršího formátu, který umísťuje vlastnosti specifické pro zásady do objektu kontejneru vlastností.
Typ: | SwitchParameter |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-Confirm
Před spuštěním rutiny vás vyzve k potvrzení.
Typ: | SwitchParameter |
Aliasy: | cf |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-DefaultProfile
Parametr DefaultProfile není funkční. Pokud je k dispozici spuštění rutiny pro jiné předplatné, použijte parametr SubscriptionId.
Typ: | PSObject |
Aliasy: | AzureRMContext, AzureCredential |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-Force
Když $true, přeskočte potvrzovací výzvy
Typ: | SwitchParameter |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-Id
ID přiřazení zásady, které chcete odstranit. Použijte formát {scope}/providers/Microsoft.Authorization/policyAssignments/{policyAssignmentName}.
Typ: | String |
Aliasy: | ResourceId, PolicyAssignmentId |
Position: | Named |
Default value: | None |
Vyžadováno: | True |
Přijmout vstup kanálu: | True |
Přijmout zástupné znaky: | False |
-InputObject
Parametr Identity To construct, see NOTES section for INPUTOBJECT properties and create a hash table.
Typ: | IPolicyIdentity |
Position: | Named |
Default value: | None |
Vyžadováno: | True |
Přijmout vstup kanálu: | True |
Přijmout zástupné znaky: | False |
-Name
Název přiřazení zásady, která se má odstranit.
Typ: | String |
Aliasy: | PolicyAssignmentName |
Position: | Named |
Default value: | None |
Vyžadováno: | True |
Přijmout vstup kanálu: | True |
Přijmout zástupné znaky: | False |
-PassThru
Vrátí hodnotu true, když příkaz proběhne úspěšně.
Typ: | SwitchParameter |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-Scope
Rozsah přiřazení zásady. Platné obory jsou: skupina pro správu (formát: /providers/Microsoft.Management/managementGroups/{managementGroup}), předplatné (formát: /subscriptions/{subscriptionId}), skupina prostředků (formát: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}, nebo prostředek (formát: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/[{parentResourcePath}/]{resourceType}/{resourceName}'
Typ: | String |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | True |
Přijmout zástupné znaky: | False |
-WhatIf
Ukazuje, co se stane, když se rutina spustí. Rutina se nespustí.
Typ: | SwitchParameter |
Aliasy: | wi |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
Vstupy
Výstupy
Azure PowerShell