New-AzContainerInstanceContainerGroupProfile

モジュール:

Az.ContainerInstance

指定した構成でコンテナー グループ プロファイルを作成または更新します。

構文

New-AzContainerInstanceContainerGroupProfile
   -Name <String>
   -ResourceGroupName <String>
   [-SubscriptionId <String>]
   -Container <IContainer[]>
   -OSType <OperatingSystemTypes>
   [-ConfidentialComputePropertyCcePolicy <String>]
   [-EncryptionPropertyIdentity <String>]
   [-EncryptionPropertyKeyName <String>]
   [-EncryptionPropertyKeyVersion <String>]
   [-EncryptionPropertyVaultBaseUrl <String>]
   [-Extension <IDeploymentExtensionSpec[]>]
   [-IPAddressAutoGeneratedDomainNameLabelScope <DnsNameLabelReusePolicy>]
   [-IPAddressDnsNameLabel <String>]
   [-IPAddressIP <String>]
   [-IPAddressPort <IPort[]>]
   [-IPAddressType <ContainerGroupIPAddressType>]
   [-ImageRegistryCredential <IImageRegistryCredential[]>]
   [-InitContainer <IInitContainerDefinition[]>]
   [-Location <String>]
   [-LogAnalyticLogType <LogAnalyticsLogType>]
   [-LogAnalyticMetadata <Hashtable>]
   [-LogAnalyticWorkspaceId <String>]
   [-LogAnalyticWorkspaceKey <String>]
   [-LogAnalyticWorkspaceResourceId <String>]
   [-Priority <ContainerGroupPriority>]
   [-RestartPolicy <ContainerGroupRestartPolicy>]
   [-Sku <ContainerGroupSku>]
   [-Tag <Hashtable>]
   [-Volume <IVolume[]>]
   [-Zone <String[]>]
   [-DefaultProfile <PSObject>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

説明

指定した構成でコンテナー グループ プロファイルを作成または更新します。

例

例 1: コンテナー インスタンスを含むコンテナー グループ プロファイルを作成し、ポートを開くパブリック IP アドレスを要求する

$port1 = New-AzContainerInstancePortObject -Port 8000 -Protocol TCP
$port2 = New-AzContainerInstancePortObject -Port 8001 -Protocol TCP
$container = New-AzContainerInstanceObject -Name test-container -Image nginx -RequestCpu 1 -RequestMemoryInGb 1.5 -Port @($port1, $port2)
$containerGroupProfile = New-AzContainerInstanceContainerGroupProfile -ResourceGroupName test-rg -Name test-cgp -Location eastus -Container $container -OsType Linux -RestartPolicy "Never" -IpAddressType Public

Location Name    Zone ResourceGroupName
-------- ----    ---- -----------------
eastus   test-cgp      test-rg

このコマンドは、イメージが最新の nginx であるコンテナー インスタンスを含むコンテナー グループ プロファイルを作成し、ポート 8000 と 8001 を開いてパブリック IP アドレスを要求します。

例 2: コンテナー グループ プロファイルを作成し、コンテナー内でカスタム スクリプトを実行します。

$pwd = ConvertTo-SecureString -String "****" -AsPlainText -Force
$env1 = New-AzContainerInstanceEnvironmentVariableObject -Name "env1" -Value "value1"
$env2 = New-AzContainerInstanceEnvironmentVariableObject -Name "env2" -SecureValue $pwd
$container = New-AzContainerInstanceObject -Name test-container -Image alpine -Command "/bin/sh -c myscript.sh" -EnvironmentVariable @($env1, $env2) -RequestCpu 1 -RequestMemoryInGb 1.5
$containerGroupProfile = New-AzContainerInstanceContainerGroupProfile -ResourceGroupName test-rg -Name test-cgp -Location eastus -Container $container -OsType Linux

Location Name    Zone ResourceGroupName
-------- ----    ---- -----------------
eastus   test-cgp      test-rg

このコマンドは、コンテナー グループ プロファイルを作成し、コンテナー内でカスタム スクリプトを実行します。

例 3: Azure Container Registry でイメージ nginx を使用してコンテナー インスタンスを含むコンテナー グループ プロファイルを作成する

$pwd = ConvertTo-SecureString -String "****" -AsPlainText -Force
$container = New-AzContainerInstanceObject -Name test-container -Image myacr.azurecr.io/nginx:latest -RequestCpu 1 -RequestMemoryInGb 1.5
$imageRegistryCredential = New-AzContainerGroupImageRegistryCredentialObject -Server "myacr.azurecr.io" -Username "username" -Password $pwd
$containerGroupProfile = New-AzContainerInstanceContainerGroupProfile -ResourceGroupName test-rg -Name test-cgp -Location eastus -Container $container -ImageRegistryCredential $imageRegistryCredential -OsType Linux

Location Name    Zone ResourceGroupName
-------- ----    ---- -----------------
eastus   test-cgp      test-rg

このコマンドは、Azure Container Registry のイメージが nginx であるコンテナー インスタンスを含むコンテナー グループ プロファイルを作成します。

例 4: スポット優先度を持つコンテナー グループ プロファイルと nginx イメージを使用してコンテナー インスタンスを作成する

$container = New-AzContainerInstanceObject -Name test-container -Image nginx -RequestCpu 1 -RequestMemoryInGb 1.5
$containerGroupProfile = New-AzContainerInstanceContainerGroupProfile -ResourceGroupName test-rg -Name test-cgp -Location eastus -Container $container -OsType Linux -RestartPolicy Never -Priority Spot

Location Name    Zone ResourceGroupName
-------- ----    ---- -----------------
eastus   test-cgp      test-rg

このコマンドでは、スポット優先度を持つコンテナー グループ プロファイルと、イメージが nginx であるコンテナー インスタンスが作成されます。

パラメーター

-ConfidentialComputePropertyCcePolicy

base64 でエンコードされた機密コンピューティング適用ポリシー

型:	String
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Confirm

コマンドレットを実行する前に確認を求めるメッセージが表示されます。

型:	SwitchParameter
Aliases:	cf
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Container

コンテナー グループ内のコンテナー。 作成するには、CONTAINER プロパティの NOTES セクションを参照し、ハッシュ テーブルを作成します。

型:	IContainer[]
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-DefaultProfile

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

型:	PSObject
Aliases:	AzureRMContext, AzureCredential
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-EncryptionPropertyIdentity

keyvault マネージド ID。

型:	String
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-EncryptionPropertyKeyName

暗号化キーの名前。

型:	String
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-EncryptionPropertyKeyVersion

暗号化キーのバージョン。

型:	String
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-EncryptionPropertyVaultBaseUrl

keyvault のベース URL。

型:	String
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Extension

仮想 kubelet で使用される拡張機能を構築するには、EXTENSION プロパティの NOTES セクションを参照し、ハッシュ テーブルを作成します。

型:	IDeploymentExtensionSpec[]
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-ImageRegistryCredential

コンテナー グループの作成元のイメージ レジストリ資格情報。 構築するには、IMAGEREGISTRYCREDENTIAL プロパティの NOTES セクションを参照し、ハッシュ テーブルを作成します。

型:	IImageRegistryCredential[]
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-InitContainer

コンテナー グループの init コンテナー。 構築するには、INITCONTAINER プロパティの NOTES セクションを参照し、ハッシュ テーブルを作成します。

型:	IInitContainerDefinition[]
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-IPAddressAutoGeneratedDomainNameLabelScope

セキュリティ列挙型を表す値。 'Unsecure' 値は、選択されていない場合の既定値であり、オブジェクトのドメイン名ラベルがサブドメインの引き継ぎに対してセキュリティで保護されていないことを意味します。 [TenantReuse] の値が選択されている場合は既定値であり、オブジェクトのドメイン名ラベルを同じテナント内で再利用できることを意味します。 "SubscriptionReuse" 値は、オブジェクトのドメイン名ラベルを同じサブスクリプション内で再利用できることを意味します。 'ResourceGroupReuse' 値は、オブジェクトのドメイン名ラベルを同じリソース グループ内で再利用できることを意味します。 'NoReuse' 値は、オブジェクトのドメイン名ラベルを同じリソース グループ、サブスクリプション、またはテナント内で再利用できないことを意味します。

型:	DnsNameLabelReusePolicy
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-IPAddressDnsNameLabel

IP の Dns 名ラベル。

型:	String
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-IPAddressIP

パブリック インターネットに公開されている IP。

型:	String
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-IPAddressPort

コンテナー グループで公開されているポートの一覧。 構築するには、IPADDRESSPORT プロパティの NOTES セクションを参照し、ハッシュ テーブルを作成します。

型:	IPort[]
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-IPAddressType

IP がパブリック インターネットまたはプライベート VNET に公開されるかどうかを指定します。

型:	ContainerGroupIPAddressType
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Location

リソースの場所。

型:	String
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-LogAnalyticLogType

使用するログの種類。

型:	LogAnalyticsLogType
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-LogAnalyticMetadata

ログ分析のメタデータ。

型:	Hashtable
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-LogAnalyticWorkspaceId

ログ分析のワークスペース ID

型:	String
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-LogAnalyticWorkspaceKey

ログ分析のワークスペース キー

型:	String
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-LogAnalyticWorkspaceResourceId

ログ分析のワークスペース リソース ID

型:	String
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Name

コンテナー グループ プロファイルの名前。

型:	String
Aliases:	ContainerGroupProfileName
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-OSType

コンテナー グループ内のコンテナーに必要なオペレーティング システムの種類。

型:	OperatingSystemTypes
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Priority

コンテナー グループの優先順位。

型:	ContainerGroupPriority
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-ResourceGroupName

リソース グループの名前。 名前では大文字と小文字が区別されません。

型:	String
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-RestartPolicy

コンテナー グループ内のすべてのコンテナーのポリシーを再起動します。

• Always 常に再起動する- OnFailure 失敗時に再起動する- Never 再起動しない

型:	ContainerGroupRestartPolicy
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Sku

コンテナー グループの SKU。

型:	ContainerGroupSku
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-SubscriptionId

ターゲット サブスクリプションの ID。 値は UUID である必要があります。

型:	String
配置:	Named
規定値:	(Get-AzContext).Subscription.Id
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Tag

リソース タグ。

型:	Hashtable
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Volume

このコンテナー グループ内のコンテナーによってマウントできるボリュームの一覧。 構築するには、VOLUME プロパティの NOTES セクションを参照し、ハッシュ テーブルを作成します。

型:	IVolume[]
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-WhatIf

コマンドレットを実行した場合の動作を示します。 コマンドレットは実行されません。

型:	SwitchParameter
Aliases:	wi
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Zone

コンテナー グループのゾーン。

型:	String[]
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

出力

IContainerGroupProfile