Get-AzPolicyDefinition
ポリシー セットの定義を取得します。
構文
Get-AzPolicyDefinition
[-Name <String>]
[-BackwardCompatible]
[-DefaultProfile <PSObject>]
[<CommonParameters>]
Get-AzPolicyDefinition
[-Name <String>]
-ManagementGroupName <String>
[-BackwardCompatible]
[-DefaultProfile <PSObject>]
[<CommonParameters>]
Get-AzPolicyDefinition
[-Name <String>]
-SubscriptionId <String>
[-BackwardCompatible]
[-DefaultProfile <PSObject>]
[<CommonParameters>]
Get-AzPolicyDefinition
[-Name <String>]
[-Id <String>]
[-BackwardCompatible]
-Version <String>
[-DefaultProfile <PSObject>]
[<CommonParameters>]
Get-AzPolicyDefinition
[-Name <String>]
[-Id <String>]
[-ListVersion]
[-BackwardCompatible]
[-DefaultProfile <PSObject>]
[<CommonParameters>]
Get-AzPolicyDefinition
-Id <String>
[-BackwardCompatible]
[-DefaultProfile <PSObject>]
[<CommonParameters>]
Get-AzPolicyDefinition
[-SubscriptionId <String>]
[-ManagementGroupName <String>]
[-Builtin]
[-BackwardCompatible]
[-DefaultProfile <PSObject>]
[<CommonParameters>]
Get-AzPolicyDefinition
[-SubscriptionId <String>]
[-ManagementGroupName <String>]
[-Custom]
[-BackwardCompatible]
[-DefaultProfile <PSObject>]
[<CommonParameters>]
Get-AzPolicyDefinition
[-SubscriptionId <String>]
[-ManagementGroupName <String>]
[-Static]
[-BackwardCompatible]
[-DefaultProfile <PSObject>]
[<CommonParameters>]
説明
Get-AzPolicyDefinition コマンドレットは、ポリシー セット定義のコレクション、または名前または ID で識別される特定のポリシー セット定義を取得します。
例
例 1: すべてのポリシー定義を取得する
Get-AzPolicyDefinition
このコマンドは、すべてのポリシー定義を取得します。
例 2: 現在のサブスクリプションから名前でポリシー定義を取得する
Get-AzPolicyDefinition -Name 'VMPolicyDefinition'
このコマンドは、現在の既定のサブスクリプションから VMPolicyDefinition という名前のポリシー定義を取得します。
例 3: 名前で管理グループからポリシー定義を取得する
Get-AzPolicyDefinition -Name 'VMPolicyDefinition' -ManagementGroupName 'Dept42'
このコマンドは、Dept42 という名前の管理グループから VMPolicyDefinition という名前のポリシー定義を取得します。
例 4: サブスクリプションからすべての組み込みポリシー定義を取得する
Get-AzPolicyDefinition -SubscriptionId '3bf44b72-c631-427a-b8c8-53e2595398ca' -Builtin
このコマンドは、ID 3bf44b72-c631-427a-b8c8-53e2595398ca のサブスクリプションからすべての組み込みポリシー定義を取得します。
例 5: 特定のカテゴリからポリシー定義を取得する
Get-AzPolicyDefinition | Where-Object {$_.Properties.metadata.category -eq 'Tags'}
このコマンドは、カテゴリ Tags 内のすべてのポリシー定義を取得します。
例 6: リストとして書式設定されたすべてのポリシー定義の表示名、説明、ポリシーの種類、およびメタデータを取得する
Get-AzPolicyDefinition | Select-Object -Property DisplayName, Description, PolicyType, Metadata | Format-List
このコマンドは、Azure Policy 定義のリーダーフレンドリな DisplayName プロパティを見つける必要がある場合に便利です。 Metadata プロパティを解析して、ポリシー定義のバージョン番号とカテゴリの割り当てを検出できます。
例 7: [Backcompat] リストとして書式設定されたすべてのポリシー定義の表示名、説明、ポリシーの種類、およびメタデータを取得する
Get-AzPolicyDefinition -BackwardCompatible | Select-Object -ExpandProperty properties | Select-Object -Property DisplayName, Description, PolicyType, Metadata | Format-List
このコマンドは、Azure Policy 定義のリーダーフレンドリな DisplayName プロパティを見つける必要がある場合に便利です。 Metadata プロパティを解析して、ポリシー定義のバージョン番号とカテゴリの割り当てを検出できます。
パラメーター
-BackwardCompatible
プロパティ バッグ オブジェクトにポリシー固有のプロパティを配置する従来の形式を使用して、コマンドレットから成果物が返されます。
型: | SwitchParameter |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Builtin
コマンドレットが組み込みのポリシー定義のみを返すようにします。
型: | SwitchParameter |
配置: | Named |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-Custom
コマンドレットがカスタム ポリシー定義のみを返すようにします。
型: | SwitchParameter |
配置: | Named |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-DefaultProfile
Azure との通信のために使用される資格情報、アカウント、テナント、サブスクリプションです。
型: | PSObject |
Aliases: | AzureRMContext, AzureCredential |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Id
取得するポリシー定義の完全な ID。
型: | String |
Aliases: | ResourceId |
配置: | Named |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-ListVersion
コマンドレットがカスタム ポリシー定義のみを返すようにします。
型: | SwitchParameter |
配置: | Named |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-ManagementGroupName
管理グループの名前。
型: | String |
配置: | Named |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-Name
取得するポリシー定義の名前。
型: | String |
Aliases: | PolicyDefinitionName |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-Static
コマンドレットが静的ポリシー定義のみを返すようにします。
型: | SwitchParameter |
配置: | Named |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-SubscriptionId
ターゲット サブスクリプションの ID。
型: | String |
配置: | Named |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-Version
#.#.# 形式のポリシー定義のバージョン。
型: | String |
Aliases: | PolicyDefinitionVersion |
配置: | Named |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
入力
出力
Azure PowerShell