Get-AzPolicySetDefinition

リファレンス

モジュール:: Az.Resources

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

構文

Get-AzPolicySetDefinition
   [-Name <String>]
   [-ApiVersion <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Get-AzPolicySetDefinition
   [-Name <String>]
   -ManagementGroupName <String>
   [-ApiVersion <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Get-AzPolicySetDefinition
   [-Name <String>]
   -SubscriptionId <Guid>
   [-ApiVersion <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Get-AzPolicySetDefinition
   -Id <String>
   [-ApiVersion <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Get-AzPolicySetDefinition
   [-ManagementGroupName <String>]
   [-SubscriptionId <Guid>]
   [-Builtin]
   [-ApiVersion <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Get-AzPolicySetDefinition
   [-ManagementGroupName <String>]
   [-SubscriptionId <Guid>]
   [-Custom]
   [-ApiVersion <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [<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 {$_.Properties.metadata.category -eq "Virtual Machine"}

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

パラメーター

-ApiVersion

設定すると、使用するリソースプロバイダー API のバージョンを示します。指定しない場合、API のバージョンは、使用可能な最新のバージョンとして自動的に決定されます。

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Builtin

結果の一覧を組み込みのポリシーセット定義のみに制限します。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-Custom

結果の一覧をカスタムポリシーセット定義のみに制限します。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	True
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。例: /subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}

Type:	String
Aliases:	ResourceId
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-ManagementGroupName

取得するポリシーセット定義の管理グループの名前。

Type:	String
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

-Pre

設定すると、使用するバージョンを自動的に決定するときに、コマンドレットでプレリリース API バージョンを使用する必要があることを示します。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-SubscriptionId

取得するポリシーセット定義のサブスクリプション ID。

Type:	Nullable<T>[Guid]
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

入力

String

Nullable<T>[[System.Guid, System.Private.CoreLib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=7cec85d7bea7798e]]

出力

PSObject