Get-AzPolicyExemption

ポリシーの除外を取得します。

構文

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>]

説明

Get-AzPolicyExemption コマンドレットは、すべてのポリシー除外または特定の除外を取得します。 名前とスコープまたは ID で取得するポリシーの除外を特定します。

例 1 すべてのポリシー除外を取得する

Get-AzPolicyExemption

このコマンドは、現在のサブスクリプションのすべてのポリシー除外を取得します。 特定のスコープに関連するすべての除外を一覧表示する必要がある場合は、先祖スコープからの除外と、子孫スコープからの除外を含め、パラメーターを -IncludeDescendent 渡す必要があります。

例 2: 特定のポリシー除外を取得する

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

最初のコマンドは、Get-AzResourceGroup コマンドレットを使用して ResourceGroup11 という名前のリソース グループを取得し、$ResourceGroup変数に格納します。 2 番目のコマンドは、$ResourceGroupの ResourceId プロパティが識別するスコープの PolicyExemption07 という名前のポリシー除外を取得します。

例 3: ポリシーの割り当てに関連付けられているすべてのポリシー除外を取得する

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

最初のコマンドは、PolicyAssignment07 という名前のポリシー割り当てを取得します。 2 番目のコマンドは、ポリシーの割り当てに割り当てられているすべてのポリシー除外を取得します。

パラメーター

-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} などのスコープを含む、取得する完全修飾ポリシー除外 ID。

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

返されるポリシー除外の一覧を、この完全修飾 ID で識別されるポリシー割り当てを割り当てるユーザーに制限します。

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

-Pre

設定すると、使用するバージョンを自動的に決定するときに、コマンドレットでプレリリース 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