Remove-AzPolicyDefinition

此作業會刪除指定訂用帳戶中具有指定名稱的原則定義。

語法

Name (預設值)

Remove-AzPolicyDefinition
    -Name <String>
    [-Version <String>]
    [-Force]
    [-DefaultProfile <PSObject>]
    [-PassThru]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ManagementGroupName

Remove-AzPolicyDefinition
    -Name <String>
    -ManagementGroupId <String>
    [-Version <String>]
    [-Force]
    [-DefaultProfile <PSObject>]
    [-PassThru]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

SubscriptionId

Remove-AzPolicyDefinition
    -Name <String>
    -SubscriptionId <String>
    [-Version <String>]
    [-Force]
    [-DefaultProfile <PSObject>]
    [-PassThru]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Id

Remove-AzPolicyDefinition
    -Id <String>
    [-Version <String>]
    [-Force]
    [-DefaultProfile <PSObject>]
    [-PassThru]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

InputObject

Remove-AzPolicyDefinition
    -InputObject <IPolicyIdentity>
    [-Force]
    [-DefaultProfile <PSObject>]
    [-PassThru]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

此作業會刪除指定訂用帳戶中具有指定名稱的原則定義。

範例

範例 1:依名稱移除原則定義

Remove-AzPolicyDefinition -Name 'VMPolicyDefinition'

此命令會移除指定的原則定義。

範例 2:依資源 ID 移除原則定義

$PolicyDefinition = Get-AzPolicyDefinition -Name 'VMPolicyDefinition'
Remove-AzPolicyDefinition -Id $PolicyDefinition.Id -Force

此命令會移除指定的原則定義,而不提示使用者。

範例 3:移除以名稱標示的政策定義版本

Remove-AzPolicyDefinition -Name 'VMPolicyDefinition' -Version '1.0.1' -PassThru

此指令會移除指定的政策定義版本,當指令成功時會回傳 true。

參數

-Confirm

在執行 Cmdlet 之前,提示您進行確認。

參數屬性

類型:SwitchParameter
預設值:None
支援萬用字元:False
不要顯示:False
別名:cf

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-DefaultProfile

DefaultProfile 參數無法運作。 如果針對不同的訂用帳戶執行 Cmdlet,請使用 SubscriptionId 參數。

參數屬性

類型:PSObject
預設值:None
支援萬用字元:False
不要顯示:False
別名:AzureRMContext, AzureCredential

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-Force

$true時,略過確認提示

參數屬性

類型:SwitchParameter
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-Id

要取得的原則定義的完整 ID。

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False
別名:資源識別碼

參數集

Id
Position:Named
必要:True
來自管線的值:False
來自管線按屬性名稱的值:True
來自剩餘引數的值:False

-InputObject

Identity Parameter To construct, see NOTES section for INPUTOBJECT properties and create a hash table.

參數屬性

類型:IPolicyIdentity
預設值:None
支援萬用字元:False
不要顯示:False

參數集

InputObject
Position:Named
必要:True
來自管線的值:True
來自管線按屬性名稱的值:True
來自剩餘引數的值:False

-ManagementGroupId

管理群組的名稱。

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False
別名:管理群組名稱

參數集

ManagementGroupName
Position:Named
必要:True
來自管線的值:False
來自管線按屬性名稱的值:True
來自剩餘引數的值:False

-Name

要取得的原則定義名稱。

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False
別名:原則定義名稱

參數集

Name
Position:Named
必要:True
來自管線的值:False
來自管線按屬性名稱的值:True
來自剩餘引數的值:False

-PassThru

當命令成功時傳回 true

參數屬性

類型:SwitchParameter
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-SubscriptionId

目標訂用帳戶的標識碼。

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

SubscriptionId
Position:Named
必要:True
來自管線的值:False
來自管線按屬性名稱的值:True
來自剩餘引數的值:False

-Version

#.#.# 格式的原則定義版本。

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False
別名:原則定義版本

參數集

Name
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:True
來自剩餘引數的值:False
ManagementGroupName
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:True
來自剩餘引數的值:False
SubscriptionId
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:True
來自剩餘引數的值:False
Id
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:True
來自剩餘引數的值:False

-WhatIf

顯示 Cmdlet 執行時會發生什麼事。 指令未執行。

參數屬性

類型:SwitchParameter
預設值:None
支援萬用字元:False
不要顯示:False
別名:無線

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

CommonParameters

此 Cmdlet 支援常見參數: -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊,請參閱 about_CommonParameters。

輸入

IPolicyIdentity

String

輸出

Boolean