次の方法で共有

Get-AzPolicyAssignment

  • リファレンス
モジュール:
Az.Resources

ポリシーの割り当てを取得します。

構文

Get-AzPolicyAssignment
   [-BackwardCompatible]
   [-DefaultProfile <PSObject>]
   [<CommonParameters>]
Get-AzPolicyAssignment
   -Name <String>
   [-Scope <String>]
   [-BackwardCompatible]
   [-DefaultProfile <PSObject>]
   [<CommonParameters>]
Get-AzPolicyAssignment
   [-Scope <String>]
   -PolicyDefinitionId <String>
   [-BackwardCompatible]
   [-DefaultProfile <PSObject>]
   [<CommonParameters>]
Get-AzPolicyAssignment
   [-Scope <String>]
   [-IncludeDescendent]
   [-BackwardCompatible]
   [-DefaultProfile <PSObject>]
   [<CommonParameters>]
Get-AzPolicyAssignment
   -Scope <String>
   [-BackwardCompatible]
   [-DefaultProfile <PSObject>]
   [<CommonParameters>]
Get-AzPolicyAssignment
   -Id <String>
   [-BackwardCompatible]
   [-DefaultProfile <PSObject>]
   [<CommonParameters>]

説明

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

例

例 1: すべてのポリシー割り当てを取得する

Get-AzPolicyAssignment

このコマンドは、すべてのポリシー割り当てを取得します。

例 2: 特定のポリシー割り当てを取得する

$ResourceGroup = Get-AzResourceGroup -Name 'ResourceGroup11'
Get-AzPolicyAssignment -Name 'PolicyAssignment07' -Scope $ResourceGroup.ResourceId

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

例 3: 管理グループに割り当てられているすべてのポリシー割り当てを取得する

$mgId = 'myManagementGroup'
Get-AzPolicyAssignment -Scope '/providers/Microsoft.Management/managementgroups/$mgId'

最初のコマンドは、クエリを実行する管理グループの ID を指定します。 2 番目のコマンドは、ID 'myManagementGroup' を持つ管理グループに割り当てられているすべてのポリシー割り当てを取得します。

例 4: リストとして書式設定されたすべてのポリシー割り当てのスコープ、ポリシー セット定義識別子、および表示名を取得する

Get-AzPolicyAssignment | Select-Object -Property Scope, PolicyDefinitionID, DisplayName | Format-List

このコマンドは、Azure Policy 割り当てのリーダーフレンドリな DisplayName プロパティを見つける必要がある場合に便利です。

例 5: [Backcompat] リストとして書式設定されたすべてのポリシー割り当てのスコープ、ポリシー セット定義識別子、および表示名を取得する

Get-AzPolicyAssignment -BackwardCompatible | Select-Object -ExpandProperty properties | Select-Object -Property Scope, PolicyDefinitionID, DisplayName | Format-List

このコマンドは、Azure Policy 割り当てのリーダーフレンドリな DisplayName プロパティを見つける必要がある場合に便利です。

パラメーター

-BackwardCompatible

プロパティ バッグ オブジェクトにポリシー固有のプロパティを配置する従来の形式を使用して、コマンドレットから成果物が返されます。

型:SwitchParameter
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-DefaultProfile

DefaultProfile パラメーターは機能しません。 別のサブスクリプションに対してコマンドレットを実行する場合は、使用可能な場合は SubscriptionId パラメーターを使用します。

型:PSObject
Aliases:AzureRMContext, AzureCredential
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Id

取得するポリシー割り当ての ID。 '{scope}/providers/Microsoft.Authorization/policyAssignments/{policyAssignmentName}' の形式を使用します。

型:String
Aliases:ResourceId, PolicyAssignmentId
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-IncludeDescendent

指定されたポリシー定義 [完全修飾] ID を対象とするすべてのポリシー割り当てを取得します。

型:SwitchParameter
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-Name

取得するポリシー割り当ての名前。

型:String
Aliases:PolicyAssignmentName
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-PolicyDefinitionId

指定されたポリシー定義 [完全修飾] ID を対象とするすべてのポリシー割り当てを取得します。

型:String
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-Scope

ポリシー割り当てのスコープ。 有効なスコープは、管理グループ (形式: '/providers/Microsoft.Management/managementGroups/{managementGroup}')、サブスクリプション (形式: '/subscriptions/{subscriptionId}')、リソース グループ (形式: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}') です。 またはリソース (形式: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/[{parentResourcePath}/]{resourceType}/{resourceName}'

型:String
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

入力

SwitchParameter

String

出力

IPolicyAssignment