New-AzContainerGroup

リファレンス

モジュール:: Az.ContainerInstance

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

構文

New-AzContainerGroup
   -Name <String>
   -ResourceGroupName <String>
   [-SubscriptionId <String>]
   -Container <IContainer[]>
   -Location <String>
   [-OSType <OperatingSystemTypes>]
   [-DnsConfigNameServer <String[]>]
   [-DnsConfigOption <String>]
   [-DnsConfigSearchDomain <String>]
   [-EncryptionPropertyKeyName <String>]
   [-EncryptionPropertyKeyVersion <String>]
   [-EncryptionPropertyVaultBaseUrl <String>]
   [-IPAddressDnsNameLabel <String>]
   [-IPAddressIP <String>]
   [-IPAddressPort <IPort[]>]
   [-IPAddressType <ContainerGroupIPAddressType>]
   [-IdentityType <ResourceIdentityType>]
   [-IdentityUserAssignedIdentity <Hashtable>]
   [-ImageRegistryCredential <IImageRegistryCredential[]>]
   [-InitContainer <IInitContainerDefinition[]>]
   [-LogAnalyticLogType <LogAnalyticsLogType>]
   [-LogAnalyticMetadata <Hashtable>]
   [-LogAnalyticWorkspaceId <String>]
   [-LogAnalyticWorkspaceKey <String>]
   [-LogAnalyticWorkspaceResourceId <String>]
   [-RestartPolicy <ContainerGroupRestartPolicy>]
   [-Sku <ContainerGroupSku>]
   [-SubnetId <IContainerGroupSubnetId[]>]
   [-Tag <Hashtable>]
   [-Volume <IVolume[]>]
   [-Zone <String[]>]
   [-Priority <String>]
   [-DefaultProfile <PSObject>]
   [-AsJob]
   [-NoWait]
   [-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)
$containerGroup = New-AzContainerGroup -ResourceGroupName test-rg -Name test-cg -Location eastus -Container $container -OsType Linux -RestartPolicy "Never" -IpAddressType Public

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

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

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

$env1 = New-AzContainerInstanceEnvironmentVariableObject -Name "env1" -Value "value1"
$env2 = New-AzContainerInstanceEnvironmentVariableObject -Name "env2" -SecureValue (ConvertTo-SecureString -String "value2" -AsPlainText -Force)
$container = New-AzContainerInstanceObject -Name test-container -Image alpine -Command "/bin/sh -c myscript.sh" -EnvironmentVariable @($env1, $env2)
$containerGroup = New-AzContainerGroup -ResourceGroupName test-rg -Name test-cg -Location eastus -Container $container -OsType Linux

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

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

例 3: 実行から完了までのコンテナーグループを作成する

$container = New-AzContainerInstanceObject -Name test-container -Image alpine -Command "echo hello" 
$containerGroup = New-AzContainerGroup -ResourceGroupName test-rg -Name test-cg -Location eastus -Container $container -OsType Linux

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

このコマンドは、"hello" を出力して停止するコンテナーグループを作成します。

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

$container = New-AzContainerInstanceObject -Name test-container -Image myacr.azurecr.io/nginx:latest
$imageRegistryCredential = New-AzContainerGroupImageRegistryCredentialObject -Server "myacr.azurecr.io" -Username "username" -Password (ConvertTo-SecureString "PlainTextPassword" -AsPlainText -Force) 
$containerGroup = New-AzContainerGroup -ResourceGroupName test-rg -Name test-cg -Location eastus -Container $container -ImageRegistryCredential $imageRegistryCredential

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

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

例 5: カスタムコンテナーイメージレジストリでイメージ nginx を使用してコンテナーインスタンスを含むコンテナーグループを作成する

$container = New-AzContainerInstanceObject -Name test-container -Image myserver.com/nginx:latest
$imageRegistryCredential = New-AzContainerGroupImageRegistryCredentialObject -Server "myserver.com" -Username "username" -Password (ConvertTo-SecureString "PlainTextPassword" -AsPlainText -Force) 
$containerGroup = New-AzContainerGroup -ResourceGroupName test-rg -Name test-cg -Location eastus -Container $container -ImageRegistryCredential $imageRegistryCredential

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

このコマンドは、コンテナーインスタンスを含むコンテナーグループを作成します。そのイメージはカスタムコンテナーイメージレジストリのカスタムイメージです。

例 6: Azure File ボリュームをマウントするコンテナーグループを作成する

$volume = New-AzContainerGroupVolumeObject -Name "myvolume" -AzureFileShareName "myshare" -AzureFileStorageAccountName "username" -AzureFileStorageAccountKey (ConvertTo-SecureString "PlainTextPassword" -AsPlainText -Force)
$mount = New-AzContainerInstanceVolumeMountObject -MountPath "/aci/logs" -Name "myvolume"
$container = New-AzContainerInstanceObject -Name test-container -Image alpine -VolumeMount $mount
$containerGroup = New-AzContainerGroup -ResourceGroupName test-rg -Name test-cg -Location eastus -Container $container -Volume $volume

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

例 7: システム割り当て ID とユーザー割り当て ID を使用してコンテナーグループを作成する

$container = New-AzContainerInstanceObject -Name test-container -Image alpine
$containerGroup = New-AzContainerGroup -ResourceGroupName test-rg -Name test-cg -Location eastus -Container $container -IdentityType "SystemAssigned, UserAssigned" -IdentityUserAssignedIdentity @{"/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}" = @{}}

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

このコマンドは、システム割り当て ID とユーザー割り当て ID を持つコンテナーグループを作成します。

パラメーター

-AsJob

コマンドをジョブとして実行する

型:	SwitchParameter
Position:	Named
既定値:	None
必須:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Confirm

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

型:	SwitchParameter
Aliases:	cf
Position:	Named
既定値:	None
必須:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Container

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

型:	IContainer[]
Position:	Named
既定値:	None
必須:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-DefaultProfile

Azure との通信のために使用される資格情報、アカウント、テナント、サブスクリプションです。

型:	PSObject
Aliases:	AzureRMContext, AzureCredential
Position:	Named
既定値:	None
必須:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DnsConfigNameServer

コンテナーグループの DNS サーバー。

型:	String[]
Position:	Named
既定値:	None
必須:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DnsConfigOption

コンテナーグループの DNS オプション。

型:	String
Position:	Named
既定値:	None
必須:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DnsConfigSearchDomain

コンテナーグループ内のホスト名ルックアップ用の DNS 検索ドメイン。

型:	String
Position:	Named
既定値:	None
必須:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-EncryptionPropertyKeyName

暗号化キー名。

型:	String
Position:	Named
既定値:	None
必須:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-EncryptionPropertyKeyVersion

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

型:	String
Position:	Named
既定値:	None
必須:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-EncryptionPropertyVaultBaseUrl

keyvault ベースの URL。

型:	String
Position:	Named
既定値:	None
必須:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-IdentityType

コンテナーグループに使用される ID の種類。「SystemAssigned、UserAssigned」のタイプには、暗黙的に作成された ID とユーザーが割り当てた一連の ID の両方が含まれます。「なし」のタイプは、コンテナーグループからすべての ID を削除します。

型:	ResourceIdentityType
Position:	Named
既定値:	None
必須:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-IdentityUserAssignedIdentity

コンテナーグループに関連付けられているユーザー ID の一覧。ユーザー ID 辞書の主な照会先は、次の形式の ARM リソース ID になります: 「/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}」。

型:	Hashtable
Position:	Named
既定値:	None
必須:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ImageRegistryCredential

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

型:	IImageRegistryCredential[]
Position:	Named
既定値:	None
必須:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-InitContainer

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

型:	IInitContainerDefinition[]
Position:	Named
既定値:	None
必須:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-IPAddressDnsNameLabel

IP の DNS ラベル。

型:	String
Position:	Named
既定値:	None
必須:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-IPAddressIP

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

型:	String
Position:	Named
既定値:	None
必須:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-IPAddressPort

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

型:	IPort[]
Position:	Named
既定値:	None
必須:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-IPAddressType

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

型:	ContainerGroupIPAddressType
Position:	Named
既定値:	None
必須:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Location

リソースの場所。

型:	String
Position:	Named
既定値:	None
必須:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-LogAnalyticLogType

使用するログの種類。

型:	LogAnalyticsLogType
Position:	Named
既定値:	None
必須:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-LogAnalyticMetadata

ログ分析用のメタデータ。

型:	Hashtable
Position:	Named
既定値:	None
必須:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-LogAnalyticWorkspaceId

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

型:	String
Position:	Named
既定値:	None
必須:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-LogAnalyticWorkspaceKey

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

型:	String
Position:	Named
既定値:	None
必須:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-LogAnalyticWorkspaceResourceId

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

型:	String
Position:	Named
既定値:	None
必須:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Name

コンテナーグループの名前。

型:	String
Aliases:	ContainerGroupName
Position:	Named
既定値:	None
必須:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-NoWait

コマンドを非同期的に実行する

型:	SwitchParameter
Position:	Named
既定値:	None
必須:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-OSType

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

型:	OperatingSystemTypes
Position:	Named
既定値:	"Linux"
必須:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Priority

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

型:	String
Position:	Named
既定値:	None
必須:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ResourceGroupName

リソースグループの名前。

型:	String
Position:	Named
既定値:	None
必須:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-RestartPolicy

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

Always 常に再起動する - OnFailure 失敗した場合に再起動する - Never 再起動しない

型:	ContainerGroupRestartPolicy
Position:	Named
既定値:	None
必須:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Sku

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

型:	ContainerGroupSku
Position:	Named
既定値:	None
必須:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-SubnetId

コンテナーグループのサブネットリソース ID。構築するには、SUBNETID プロパティの NOTES セクションを参照し、ハッシュテーブルを作成します。

型:	IContainerGroupSubnetId[]
Position:	Named
既定値:	None
必須:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-SubscriptionId

Microsoft Azure サブスクリプションを一意に識別するサブスクリプション資格情報。サブスクリプション ID は、全ての修理依頼についてURI の一部を生じさせます。

型:	String
Position:	Named
既定値:	(Get-AzContext).Subscription.Id
必須:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Tag

リソースタグ。

型:	Hashtable
Position:	Named
既定値:	None
必須:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Volume

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

型:	IVolume[]
Position:	Named
既定値:	None
必須:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-WhatIf

コマンドレットの実行時に発生する内容を示します。このコマンドレットは実行されません。

型:	SwitchParameter
Aliases:	wi
Position:	Named
既定値:	None
必須:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Zone

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

型:	String[]
Position:	Named
既定値:	None
必須:	False
Accept pipeline input:	False
Accept wildcard characters:	False

出力

IContainerGroup

次の方法で共有