共用方式為


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

輸入

IPolicyIdentity

String

輸出

Boolean