Remove-AzPolicyAssignment
此作業會刪除原則指派,並指定其名稱及其建立範圍。 原則指派的範圍是其標識符前面 '/providers/Microsoft.Authorization/policyAssignments/{policyAssignmentName}' 的一部分。
語法
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
此作業會刪除原則指派,並指定其名稱及其建立範圍。 原則指派的範圍是其標識符前面 '/providers/Microsoft.Authorization/policyAssignments/{policyAssignmentName}' 的一部分。
範例
範例 1:依名稱和範圍移除原則指派
$ResourceGroup = Get-AzResourceGroup -Name 'ResourceGroup11'
Remove-AzPolicyAssignment -Name 'PolicyAssignment07' -Scope $ResourceGroup.ResourceId -Force
第一個命令會使用 Get-AzResourceGroup Cmdlet 取得名為 ResourceGroup11 的資源群組。 命令會將該物件儲存在 $ResourceGroup 變數中。 第二個命令會移除在資源群組層級指派名為 PolicyAssignment07 的原則指派。 $ResourceGroup的 ResourceId 屬性會識別資源群組。
範例 2:依標識符移除原則指派
$ResourceGroup = Get-AzResourceGroup -Name 'ResourceGroup11'
$PolicyAssignment = Get-AzPolicyAssignment -Name 'PolicyAssignment07' -Scope $ResourceGroup.ResourceId
Remove-AzPolicyAssignment -Id $PolicyAssignment.ResourceId -Confirm:$false
第一個命令會取得名為 ResourceGroup11 的資源群組,然後將該物件儲存在$ResourceGroup變數中。 第二個命令會取得資源群組層級的原則指派,然後將它儲存在$PolicyAssignment變數中。 $ResourceGroup的 ResourceId 屬性會識別資源群組。 最後一個命令會移除$PolicyAssignment ResourceId 屬性所識別的原則指派。
範例 3:[Backcompat] 依標識符移除原則指派
$ResourceGroup = Get-AzResourceGroup -Name 'ResourceGroup11'
$PolicyAssignment = Get-AzPolicyAssignment -Name 'PolicyAssignment07' -Scope $ResourceGroup.ResourceId
Remove-AzPolicyAssignment -Id $PolicyAssignment.ResourceId -Confirm:$false -BackwardCompatible
True
第一個命令會取得名為 ResourceGroup11 的資源群組,然後將該物件儲存在$ResourceGroup變數中。 第二個命令會取得資源群組層級的原則指派,然後將它儲存在$PolicyAssignment變數中。 $ResourceGroup的 ResourceId 屬性會識別資源群組。 最後一個命令會移除$PolicyAssignment ResourceId 屬性所識別的原則指派。
參數
-BackwardCompatible
導致 Cmdlet 使用舊版格式將原則特定屬性放在屬性包對象中傳回成品。
類型: | SwitchParameter |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-Confirm
執行 Cmdlet 之前先提示您確認。
類型: | SwitchParameter |
別名: | cf |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-DefaultProfile
DefaultProfile 參數無法運作。 如果針對不同的訂用帳戶執行 Cmdlet,請使用 SubscriptionId 參數。
類型: | PSObject |
別名: | AzureRMContext, AzureCredential |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-Force
$true時,略過確認提示
類型: | SwitchParameter |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-Id
要刪除的原則指派標識碼。 使用格式 '{scope}/providers/Microsoft.Authorization/policyAssignments/{policyAssignmentName}'。
類型: | String |
別名: | ResourceId, PolicyAssignmentId |
Position: | Named |
預設值: | None |
必要: | True |
接受管線輸入: | True |
接受萬用字元: | False |
-InputObject
Identity Parameter To construct, see NOTES section for INPUTOBJECT properties and create a hash table.
類型: | IPolicyIdentity |
Position: | Named |
預設值: | None |
必要: | True |
接受管線輸入: | True |
接受萬用字元: | False |
-Name
要刪除的原則指派名稱。
類型: | String |
別名: | PolicyAssignmentName |
Position: | Named |
預設值: | None |
必要: | True |
接受管線輸入: | True |
接受萬用字元: | False |
-PassThru
當命令成功時傳回 true
類型: | SwitchParameter |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-Scope
原則指派的範圍。 有效範圍包括:管理群組(格式:'/providers/Microsoft.Management/managementGroups/{managementGroup}'),訂用帳戶(格式:'/subscriptions/{subscriptionId}'),資源群組(格式: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}', 或資源 (格式: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/[{parentResourcePath}/]{resourceType}/{resourceName}'
類型: | String |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | True |
接受萬用字元: | False |
-WhatIf
顯示執行 Cmdlet 後會發生的情況。 未執行 Cmdlet。
類型: | SwitchParameter |
別名: | wi |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |