Remove-AzPolicyEnrollment

刪除一份保單登記。

語法

DeleteByNameAndScope (預設值)

Remove-AzPolicyEnrollment
    -Name <String>
    -Scope <String>
    [-Force]
    [-DefaultProfile <PSObject>]
    [-PassThru]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

DeleteById

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

DeleteByInputObject

Remove-AzPolicyEnrollment
    -InputObject <IPolicyEnrollment>
    [-Force]
    [-DefaultProfile <PSObject>]
    [-PassThru]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

Remove-AzPolicyEnrollment 指令檔會刪除政策註冊,根據其名稱及所建立的範圍。 政策註冊的範圍是其 ID 中位於 '/providers/Microsoft.Authorization/policyEnrollments/{policyEnrollmentName}' 之前的部分。

範例

範例 1:依名稱及範圍移除保單登記

$ResourceGroup = Get-AzResourceGroup -Name 'ResourceGroup11'
Remove-AzPolicyEnrollment -Name 'PolicyEnrollment07' -Scope $ResourceGroup.ResourceId -Confirm

第一個命令會使用 Get-AzResourceGroup Cmdlet 取得名為 ResourceGroup11 的資源群組。 此指令會將該物件儲存在$ResourceGroup變數中。 第二個指令則移除資源群組範圍內名為 PolicyEnrollment07 的政策註冊。 $ResourceGroup 的 ResourceId 屬性會識別資源群組。

範例 2:移除依 ID 進行保單登記

$ResourceGroup = Get-AzResourceGroup -Name 'ResourceGroup11'
$PolicyEnrollment = Get-AzPolicyEnrollment -Name 'PolicyEnrollment07' -Scope $ResourceGroup.ResourceId
Remove-AzPolicyEnrollment -Id $PolicyEnrollment.Id -Force

第一個命令會取得名為 ResourceGroup11 的資源群組,然後將該物件儲存在 $ResourceGroup 變數中。 第二個指令是在資源群組層級取得政策註冊,然後儲存在 $PolicyEnrollment 變數中。 $ResourceGroup 的 ResourceId 屬性會識別資源群組。 最後一個指令會移除 $PolicyEnrollment 的 Id 屬性所識別的政策註冊,繞過帶有 Force 參數的確認提示。

參數

-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。 請使用格式為 '{scope}/providers/Microsoft.授權/policyEnrollments/{policyEnrollmentName}'。

參數屬性

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

參數集

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

-InputObject

要刪除的政策註冊物件。

參數屬性

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

參數集

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

-Name

保單登記名稱。

參數屬性

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

參數集

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

-PassThru

當命令成功時傳回 true

參數屬性

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

參數集

(All)
Position:Named
必要:False
來自管線的值: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
預設值:None
支援萬用字元:False
不要顯示:False

參數集

DeleteByNameAndScope
Position:Named
必要:True
來自管線的值: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。

輸入

IPolicyEnrollment

String

輸出

Boolean