次の方法で共有


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

入力

SwitchParameter

String

出力

IPolicyDefinition