Get-AzPolicySetDefinition

ポリシー セットの定義を取得します。

構文

Name (既定)

Get-AzPolicySetDefinition
    [-Name <String>]
    [-ListVersion]
    [-Expand <String>]
    [-Version <String>]
    [-DefaultProfile <PSObject>]
    [<CommonParameters>]

ManagementGroupName

Get-AzPolicySetDefinition
    -ManagementGroupName <String>
    [-Name <String>]
    [-ListVersion]
    [-Expand <String>]
    [-Version <String>]
    [-DefaultProfile <PSObject>]
    [<CommonParameters>]

SubscriptionId

Get-AzPolicySetDefinition
    -SubscriptionId <String>
    [-Name <String>]
    [-ListVersion]
    [-Expand <String>]
    [-Version <String>]
    [-DefaultProfile <PSObject>]
    [<CommonParameters>]

Builtin

Get-AzPolicySetDefinition
    [-SubscriptionId <String>]
    [-ManagementGroupName <String>]
    [-Builtin]
    [-DefaultProfile <PSObject>]
    [<CommonParameters>]

Custom

Get-AzPolicySetDefinition
    [-SubscriptionId <String>]
    [-ManagementGroupName <String>]
    [-Custom]
    [-DefaultProfile <PSObject>]
    [<CommonParameters>]

Id

Get-AzPolicySetDefinition
    -Id <String>
    [-ListVersion]
    [-Expand <String>]
    [-Version <String>]
    [-DefaultProfile <PSObject>]
    [<CommonParameters>]

説明

Get-AzPolicySetDefinition コマンドレットは、ポリシー セット定義のコレクション、または名前または ID で識別される特定のポリシー セット定義を取得します。

例 1: すべてのポリシー セット定義を取得する

Get-AzPolicySetDefinition

このコマンドは、すべてのポリシー セット定義を取得します。

例 2: 現在のサブスクリプションから名前でポリシー セット定義を取得する

Get-AzPolicySetDefinition -Name 'VMPolicySetDefinition'

このコマンドは、現在の既定のサブスクリプションから VMPolicySetDefinition という名前のポリシー セット定義を取得します。

例 3: サブスクリプションから名前でポリシー セット定義を取得する

Get-AzPolicySetDefinition -Name 'VMPolicySetDefinition' -subscriptionId '3bf44b72-c631-427a-b8c8-53e2595398ca'

このコマンドは、ID 3bf44b72-c631-427a-b8c8-53e2595398ca のサブスクリプションから VMPolicySetDefinition という名前のポリシー定義を取得します。

例 4: 管理グループからすべてのカスタム ポリシー セット定義を取得する

Get-AzPolicySetDefinition -ManagementGroupName 'Dept42' -Custom

このコマンドは、Dept42 という名前の管理グループからすべてのカスタム ポリシー セット定義を取得します。

例 5: 特定のカテゴリからポリシー セット定義を取得する

Get-AzPolicySetDefinition | Where-Object {$_.metadata.category -eq "Virtual Machine"}

このコマンドは、カテゴリ "仮想マシン" のすべてのポリシー セット定義を取得します。

例 6: ID でポリシー セット定義のバージョンを取得する

Get-AzPolicySetDefinition -Id '/providers/Microsoft.Authorization/policySetDefinitions/1bb84455-9e6e-434c-8db6-fa6d03a67e87' -Version "1.1.1"

このコマンドは、ID /providers/Microsoft を持つポリシー定義のバージョン 1.1.1 を取得します。Authorization/policySetDefinitions/1bb84455-9e6e-434c-8db6-fa6d03a67e87.

例 7: ポリシー セット定義のすべてのポリシー セット定義バージョンを名前で取得する

Get-AzPolicySetDefinition -Name 'VMPolicySetDefinition' -ListVersion

このコマンドは、現在の既定のサブスクリプションから、VMPolicySetDefinition という名前のポリシー セット定義のすべてのポリシー セット定義バージョンを取得します。

パラメーター

-Builtin

コマンドレットが組み込みのポリシー セット定義のみを返すようにします。

パラメーターのプロパティ

型:SwitchParameter
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

Builtin
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False

-Custom

コマンドレットがカスタム ポリシー セット定義のみを返すようにします。

パラメーターのプロパティ

型:SwitchParameter
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

Custom
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False

-DefaultProfile

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

パラメーターのプロパティ

型:PSObject
規定値:None
ワイルドカードのサポート:False
DontShow:False
Aliases:AzureRMContext, AzureCredential

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-Expand

応答に含める追加プロパティのコンマ区切りの一覧。 サポートされている値は 'LatestDefinitionVersion, EffectiveDefinitionVersion' です。

パラメーターのプロパティ

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

Name
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False
ManagementGroupName
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False
SubscriptionId
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False
Id
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False

-Id

取得するポリシー セット定義の完全な ID。

パラメーターのプロパティ

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False
Aliases:リソースID

パラメーター セット

Id
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False

-ListVersion

コマンドレットがカスタム ポリシー セット定義バージョンのみを返すようにします。

パラメーターのプロパティ

型:SwitchParameter
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

Name
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False
ManagementGroupName
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False
SubscriptionId
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False
Id
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False

-ManagementGroupName

管理グループの名前。

パラメーターのプロパティ

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

ManagementGroupName
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False

-Name

ポリシーセットの定義名を取得すること。

パラメーターのプロパティ

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False
Aliases:PolicySetDefinitionName

パラメーター セット

Name
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False
ManagementGroupName
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False
SubscriptionId
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False

-SubscriptionId

ターゲット サブスクリプションの ID。

パラメーターのプロパティ

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

SubscriptionId
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False

-Version

#.#.# 形式のポリシー セット定義のバージョン。

パラメーターのプロパティ

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False
Aliases:PolicySetDefinitionVersion

パラメーター セット

Name
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False
ManagementGroupName
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False
SubscriptionId
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False
Id
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False

CommonParameters

このコマンドレットは、共通パラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable をサポートします。 詳細については、about_CommonParametersを参照してください。

入力

SwitchParameter

String

出力

IPolicySetDefinition