Get-AzPolicyAssignment
ポリシーの割り当てを取得します。
構文
Get-AzPolicyAssignment
[-ApiVersion <String>]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Get-AzPolicyAssignment
[-Name <String>]
[-Scope <String>]
[-PolicyDefinitionId <String>]
[-ApiVersion <String>]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Get-AzPolicyAssignment
[-Scope <String>]
[-IncludeDescendent]
[-ApiVersion <String>]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Get-AzPolicyAssignment
-Id <String>
[-PolicyDefinitionId <String>]
[-ApiVersion <String>]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[<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 -ExpandProperty properties | Select-Object -Property Scope, PolicyDefinitionID, DisplayName | Format-List
このコマンドは、Azure Policy 割り当てのリーダーフレンドリな DisplayName プロパティを見つける必要がある場合に便利です。
パラメーター
-ApiVersion
使用するリソース プロバイダー 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
このコマンドレットが取得するポリシー割り当ての完全修飾リソース 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 |
-PolicyDefinitionId
このコマンドレットが取得するポリシー割り当てのポリシー定義の 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
このコマンドレットが取得する割り当てにポリシーを適用するスコープを指定します。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |