az lab vm

  • プレビュー
  • リファレンス

コマンド グループ 'lab' はプレビュー段階であり、開発中です。 参照レベルとサポート レベル: https://aka.ms/CLI_refstatus

Azure DevTest ラボで VM を管理する。

コマンド

名前 説明 型 Status
az lab vm apply-artifacts

Azure DevTest Lab の仮想マシンにアーティファクトを適用します。

 コア プレビュー
az lab vm claim

ラボから仮想マシンを要求します。

 コア プレビュー
az lab vm create

ラボ内の VM を削除する

 コア プレビュー
az lab vm delete

仮想マシンを削除します。

 コア プレビュー
az lab vm list

Azure DevTest ラボ内の VM を一覧表示します。

 コア プレビュー
az lab vm show

仮想マシンを取得します。

 コア プレビュー
az lab vm start

仮想マシンを起動します。

 コア プレビュー
az lab vm stop

仮想マシンを停止します。この操作が完了するまでに時間がかかる場合があります。

 コア プレビュー

az lab vm apply-artifacts

編集
プレビュー

コマンド グループ 'lab' はプレビュー段階であり、開発中です。 参照レベルとサポート レベル: https://aka.ms/CLI_refstatus

Azure DevTest Lab の仮想マシンにアーティファクトを適用します。

az lab vm apply-artifacts --lab-name
                          --name
                          --resource-group
                          [--artifacts]

例

Azure DevTest Lab の仮想マシンにアーティファクトを適用します。 (自動生成)

az lab vm apply-artifacts --artifacts '@artifacts.json' --lab-name MyLab --name MyVirtualMachine --resource-group MyResourceGroup

必須のパラメーター

--lab-name

ラボの名前。

--name -n

仮想マシンの名前。

--resource-group -g

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

省略可能のパラメーター

--artifacts

適用するアーティファクトの JSON エンコード配列。 '@{file}' を使用してファイルから読み込みます。

グローバル パラメーター
--debug

すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。

--help -h

このヘルプ メッセージを表示して終了します。

--only-show-errors

エラーのみを表示し、警告は抑制します。

--output -o

出力形式。

承認された値: json, jsonc, none, table, tsv, yaml, yamlc
既定値: json
--query

JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ をご覧ください。

--subscription

サブスクリプションの名前または ID。 az account set -s NAME_OR_ID を使用して、既定のサブスクリプションを構成できます。

--verbose

ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --debug を使います。

az lab vm claim

編集
プレビュー

コマンド グループ 'lab' はプレビュー段階であり、開発中です。 参照レベルとサポート レベル: https://aka.ms/CLI_refstatus

ラボから仮想マシンを要求します。

az lab vm claim [--ids]
                [--lab-name]
                [--name]
                [--resource-group]
                [--subscription]

例

ラボで使用可能な仮想マシンを要求します。

az lab vm claim -g {ResourceGroup} --lab-name {LabName}

ラボ内の特定の仮想マシンを要求します。

az lab vm claim -g {ResourceGroup} --lab-name {LabName} --name {VMName}

ID によってラボ内の複数の仮想マシンを要求します。

az lab vm claim --ids \
    /subscriptions/{SubID}/resourcegroups/{ResourceGroup}/providers/microsoft.devtestlab/labs/{LabName}/virtualmachines/{VMName1} \
    /subscriptions/{SubID}/resourcegroups/{ResourceGroup}/providers/microsoft.devtestlab/labs/{LabName}/virtualmachines/{VMName2}

省略可能のパラメーター

--ids

1 つまたは複数のリソース ID (スペース区切り)。 これは、'Resource Id' 引数のすべての情報を含む完全なリソース ID である必要があります。 --ids または他の 'Resource Id' 引数を指定する必要があります。

--lab-name

ラボの名前。

--name -n

要求する仮想マシンの名前。

--resource-group -g

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

--subscription

サブスクリプションの名前または ID。 az account set -s NAME_OR_ID を使用して、既定のサブスクリプションを構成できます。

グローバル パラメーター
--debug

すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。

--help -h

このヘルプ メッセージを表示して終了します。

--only-show-errors

エラーのみを表示し、警告は抑制します。

--output -o

出力形式。

承認された値: json, jsonc, none, table, tsv, yaml, yamlc
既定値: json
--query

JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ をご覧ください。

--subscription

サブスクリプションの名前または ID。 az account set -s NAME_OR_ID を使用して、既定のサブスクリプションを構成できます。

--verbose

ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --debug を使います。

az lab vm create

編集
プレビュー

コマンド グループ 'lab' はプレビュー段階であり、開発中です。 参照レベルとサポート レベル: https://aka.ms/CLI_refstatus

ラボ内の VM を削除する

az lab vm create --lab-name
                 --name
                 --resource-group
                 [--admin-password]
                 [--admin-username]
                 [--allow-claim]
                 [--artifacts]
                 [--authentication-type]
                 [--disk-type]
                 [--expiration-date]
                 [--formula]
                 [--generate-ssh-keys]
                 [--image]
                 [--image-type]
                 [--ip-configuration]
                 [--notes]
                 [--saved-secret]
                 [--size]
                 [--ssh-key]
                 [--subnet]
                 [--tags]
                 [--vnet-name]

例

ギャラリー イメージからラボに VM を作成します。

az lab vm create --lab-name {LabName} -g {ResourceGroup} --name {VMName} --image "Ubuntu Server 16.04 LTS" --image-type gallery --size Standard_DS1_v2

SSH 認証を使用してギャラリー イメージからラボに VM を作成します。

az lab vm create --lab-name {LabName} -g {ResourceGroup} --name {VMName} --image "Ubuntu Server 16.04 LTS" --image-type gallery --size Standard_DS1_v2 --authentication-type ssh

パスワード認証を使用して、ギャラリー イメージからラボに要求可能な VM を作成します。

az lab vm create --lab-name {LabName} -g {ResourceGroup} --name {VMName} --image "Ubuntu Server 16.04 LTS" --image-type gallery --size Standard_DS1_v2 --allow-claim

パスワード認証を使用してギャラリー イメージからラボに Windows VM を作成します。

az lab vm create --lab-name {LabName} -g {ResourceGroup} --name {VMName} --image "Windows Server 2008 R2 SP1" --image-type gallery --size Standard_DS1_v2

カスタム イメージからラボに VM を作成します。

az lab vm create --lab-name {LabName} -g {ResourceGroup} --name {VMName} --image "jenkins_custom" --image-type custom --size Standard_DS1_v2

パブリック IP を使用してラボに VM を作成します。

az lab vm create --lab-name {LabName} -g {ResourceGroup} --name {VMName} --image "Ubuntu Server 16.04 LTS" --image-type gallery --size Standard_DS1_v2 --ip-configuration public

数式から VM を作成します。

az lab vm create --lab-name {LabName} -g {ResourceGroup} --name {VMName} --formula MyFormula --artifacts '@artifacts.json'

必須のパラメーター

--lab-name

ラボの名前。

--name -n

仮想マシンの名前。

--resource-group -g

リソース グループの名前。 az configure --defaults group=<name> を使用して、既定のグループを構成できます。

省略可能のパラメーター

--admin-password

VM 管理者のパスワード。

--admin-username

VM 管理者のユーザー名。

既定値: your_system_user_login_name
--allow-claim

VM を要求可能として作成する必要があるかどうかを示すフラグ。

既定値: False
--artifacts

適用するアーティファクトの JSON エンコード配列。 '@{file}' を使用してファイルから読み込みます。

--authentication-type

VM に対して許可される認証の種類。 使用できる値は、password、ssh です。

既定値: password
--disk-type

仮想マシンに使用するストレージの種類。 使用できる値は、プレミアム、Standard、StandardSSD です。

--expiration-date

VM の UTC (yyyy-MM-ddTHH:mm:ss) の有効期限。

--formula

数式の名前。 使用可能な数式に使用 az lab formula list します。

フラグと共に--export-artifacts使用az lab formulaしてアーティファクトをエクスポートおよび更新し、引数を使用して結果を--artifacts渡します。

--generate-ssh-keys

SSH 公開キー ファイルおよび SSH 秘密キー ファイルがない場合は生成します。

--image

オペレーティング システム イメージの名前 (ギャラリー イメージ名またはカスタム イメージ名/ID)。

使用可能なギャラリー イメージまたはaz lab custom-image list使用可能なカスタム イメージに使用az lab gallery-image listします。

--image-type

イメージの種類。 使用できる値は、ギャラリー、カスタムです。

--ip-configuration

VM に使用する IP 構成の種類。 使用できる値は、shared、public、private です。

省略すると、VM の vnet に基づいて選択されます。

--notes

仮想マシンに関するメモ。

--saved-secret

認証に使用する保存済みシークレットの名前。

この値を指定すると、他の認証方法の代わりに使用されます。

--size

作成する VM のサイズ。 サイズ情報を参照してください https://azure.microsoft.com/pricing/details/virtual-machines/ 。

--ssh-key

SSH 公開キーまたは公開キー ファイルのパス。 SSH キーを生成するために使用 --generate-ssh-keys します。

--subnet

VM を追加するサブネットの名前。

--tags

スペースで区切られた形式の key[=value] タグ。

タグは、空の値 "" を割り当てることでクリアできます。

--vnet-name

VM を追加する仮想ネットワークの名前。

グローバル パラメーター
--debug

すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。

--help -h

このヘルプ メッセージを表示して終了します。

--only-show-errors

エラーのみを表示し、警告は抑制します。

--output -o

出力形式。

承認された値: json, jsonc, none, table, tsv, yaml, yamlc
既定値: json
--query

JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ をご覧ください。

--subscription

サブスクリプションの名前または ID。 az account set -s NAME_OR_ID を使用して、既定のサブスクリプションを構成できます。

--verbose

ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --debug を使います。

az lab vm delete

編集
プレビュー

コマンド グループ 'lab' はプレビュー段階であり、開発中です。 参照レベルとサポート レベル: https://aka.ms/CLI_refstatus

仮想マシンを削除します。

この操作を完了するにはしばらく時間がかかることがあります。

az lab vm delete --lab-name
                 --name
                 --resource-group

必須のパラメーター

--lab-name

ラボの名前。

--name

仮想マシンの名前。

--resource-group -g

リソース グループの名前。 az configure --defaults group=<name> を使用して、既定のグループを構成できます。

グローバル パラメーター
--debug

すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。

--help -h

このヘルプ メッセージを表示して終了します。

--only-show-errors

エラーのみを表示し、警告は抑制します。

--output -o

出力形式。

承認された値: json, jsonc, none, table, tsv, yaml, yamlc
既定値: json
--query

JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ をご覧ください。

--subscription

サブスクリプションの名前または ID。 az account set -s NAME_OR_ID を使用して、既定のサブスクリプションを構成できます。

--verbose

ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --debug を使います。

az lab vm list

編集
プレビュー

コマンド グループ 'lab' はプレビュー段階であり、開発中です。 参照レベルとサポート レベル: https://aka.ms/CLI_refstatus

Azure DevTest ラボ内の VM を一覧表示します。

az lab vm list --lab-name
               --resource-group
               [--all]
               [--claimable]
               [--environment]
               [--expand]
               [--filters]
               [--object-id]
               [--order-by]
               [--top]

例

Azure DevTest ラボ内の VM を一覧表示します。 (自動生成)

az lab vm list --lab-name MyLab --resource-group MyResourceGroup

必須のパラメーター

--lab-name

ラボの名前。

--resource-group -g

リソース グループの名前。 az configure --defaults group=<name> を使用して、既定のグループを構成できます。

省略可能のパラメーター

--all

ラボ内のすべての仮想マシンを一覧表示します。 --filters と一緒には使用できません。

--claimable

ラボ内の要求可能な仮想マシンのみを一覧表示します。 --filters と一緒には使用できません。

--environment

仮想マシンを一覧表示する環境の名前または ID。 --filters と一緒には使用できません。

--expand

展開クエリ。

--filters

適用するフィルター。

--object-id

VM を一覧表示する所有者のオブジェクト ID。

--order-by

OData 表記を使用した結果の順序式。

--top

返されるリソースの最大数。

グローバル パラメーター
--debug

すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。

--help -h

このヘルプ メッセージを表示して終了します。

--only-show-errors

エラーのみを表示し、警告は抑制します。

--output -o

出力形式。

承認された値: json, jsonc, none, table, tsv, yaml, yamlc
既定値: json
--query

JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ をご覧ください。

--subscription

サブスクリプションの名前または ID。 az account set -s NAME_OR_ID を使用して、既定のサブスクリプションを構成できます。

--verbose

ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --debug を使います。

az lab vm show

編集
プレビュー

コマンド グループ 'lab' はプレビュー段階であり、開発中です。 参照レベルとサポート レベル: https://aka.ms/CLI_refstatus

仮想マシンを取得します。

az lab vm show --lab-name
               --name
               --resource-group
               [--expand]

必須のパラメーター

--lab-name

ラボの名前。

--name

仮想マシンの名前。

--resource-group -g

リソース グループの名前。 az configure --defaults group=<name> を使用して、既定のグループを構成できます。

省略可能のパラメーター

--expand

$expand クエリを指定します。 例: 'properties($expand=artifacts,computeVm,networkInterface,applicableSchedule)'。

グローバル パラメーター
--debug

すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。

--help -h

このヘルプ メッセージを表示して終了します。

--only-show-errors

エラーのみを表示し、警告は抑制します。

--output -o

出力形式。

承認された値: json, jsonc, none, table, tsv, yaml, yamlc
既定値: json
--query

JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ をご覧ください。

--subscription

サブスクリプションの名前または ID。 az account set -s NAME_OR_ID を使用して、既定のサブスクリプションを構成できます。

--verbose

ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --debug を使います。

az lab vm start

編集
プレビュー

コマンド グループ 'lab' はプレビュー段階であり、開発中です。 参照レベルとサポート レベル: https://aka.ms/CLI_refstatus

仮想マシンを起動します。

この操作を完了するにはしばらく時間がかかることがあります。

az lab vm start --lab-name
                --name
                --resource-group

必須のパラメーター

--lab-name

ラボの名前。

--name

仮想マシンの名前。

--resource-group -g

リソース グループの名前。 az configure --defaults group=<name> を使用して、既定のグループを構成できます。

グローバル パラメーター
--debug

すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。

--help -h

このヘルプ メッセージを表示して終了します。

--only-show-errors

エラーのみを表示し、警告は抑制します。

--output -o

出力形式。

承認された値: json, jsonc, none, table, tsv, yaml, yamlc
既定値: json
--query

JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ をご覧ください。

--subscription

サブスクリプションの名前または ID。 az account set -s NAME_OR_ID を使用して、既定のサブスクリプションを構成できます。

--verbose

ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --debug を使います。

az lab vm stop

編集
プレビュー

コマンド グループ 'lab' はプレビュー段階であり、開発中です。 参照レベルとサポート レベル: https://aka.ms/CLI_refstatus

仮想マシンを停止します。この操作が完了するまでに時間がかかる場合があります。

az lab vm stop --lab-name
               --name
               --resource-group

必須のパラメーター

--lab-name

ラボの名前。

--name

仮想マシンの名前。

--resource-group -g

リソース グループの名前。 az configure --defaults group=<name> を使用して、既定のグループを構成できます。

グローバル パラメーター
--debug

すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。

--help -h

このヘルプ メッセージを表示して終了します。

--only-show-errors

エラーのみを表示し、警告は抑制します。

--output -o

出力形式。

承認された値: json, jsonc, none, table, tsv, yaml, yamlc
既定値: json
--query

JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ をご覧ください。

--subscription

サブスクリプションの名前または ID。 az account set -s NAME_OR_ID を使用して、既定のサブスクリプションを構成できます。

--verbose

ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --debug を使います。