Get-AzPolicyExemption

參考

模組:: Az.Resources

取得原則豁免。

Syntax

Get-AzPolicyExemption
   [-Name <String>]
   [-Scope <String>]
   [-PolicyAssignmentIdFilter <String>]
   [-ApiVersion <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Get-AzPolicyExemption
   [-Scope <String>]
   [-IncludeDescendent]
   [-ApiVersion <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Get-AzPolicyExemption
   -Id <String>
   [-PolicyAssignmentIdFilter <String>]
   [-ApiVersion <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Description

Get-AzPolicyExemption Cmdlet 會取得所有原則豁免或特定豁免。識別原則豁免，以依名稱和範圍或標識碼取得。

範例

範例 1 取得所有原則豁免

Get-AzPolicyExemption

此命令會取得目前訂用帳戶中的所有原則豁免。如果您需要列出與指定範圍相關的所有豁免，包括上階範圍中的豁免，以及來自子系範圍的所有豁免，您需要傳遞 -IncludeDescendent 參數。

範例 2：取得特定原則豁免

$ResourceGroup = Get-AzResourceGroup -Name 'ResourceGroup11'
Get-AzPolicyExemption -Name 'PolicyExemption07' -Scope $ResourceGroup.ResourceId

第一個命令會使用 Get-AzResourceGroup Cmdlet 取得名為 ResourceGroup11 的資源群組，並將它儲存在$ResourceGroup變數中。第二個命令會取得名為 PolicyExemption07 的原則豁免，以取得$ResourceGroup ResourceId 屬性所識別的範圍。

範例 3：取得與原則指派相關聯的所有原則豁免

$Assignment = Get-AzPolicyAssignment -Name 'PolicyAssignment07'
Get-AzPolicyExemption -PolicyAssignmentIdFilter $Assignment.ResourceId

第一個命令會取得名為 PolicyAssignment07 的原則指派。第二個命令會取得使用原則指派指派的所有原則豁免。

參數

-ApiVersion

設定時，表示要使用的資源提供者 API 版本。如果未指定，API 版本會自動判斷為最新的可用版本。

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DefaultProfile

用於與 Azure 通訊的認證、帳戶、租用戶和訂用帳戶。

Type:	IAzureContextContainer
Aliases:	AzContext, AzureRmContext, AzureCredential
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Id

要取得的完整原則豁免標識符，包括範圍，例如 /subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/Microsoft.Authorization/policyExemptions/{policyExemptionName}。

Type:	String
Aliases:	ResourceId
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-IncludeDescendent

導致傳回的原則豁免清單包含與指定範圍相關的所有豁免，包括上階範圍和子代範圍中的豁免。當要求的範圍是管理群組範圍時，此參數無法運作。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-Name

要取得的原則豁免名稱。

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-PolicyAssignmentIdFilter

將傳回的原則豁免清單限制為指派此完整標識碼所識別的原則指派。

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-Pre

設定時，表示 Cmdlet 在自動判斷要使用的版本時，應該使用發行前版本 API 版本。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Scope

要取得的原則豁免範圍，例如 /providers/managementGroups/{managementGroupName}，預設為目前的訂用帳戶。

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

輸入

String

SwitchParameter

輸出

PsPolicyExemption