az desktopvirtualization hostpool
Note
このリファレンスは、Azure CLI (バージョン 2.55.0 以降) の デスクトップ仮想化 拡張機能の一部です。 拡張機能は、az desktopvirtualization hostpool コマンドを初めて実行するときに自動的にインストールされます。 拡張機能の詳細については、 を参照してください。
デスクトップ仮想化ホスト プールを管理します。
コマンド
| 名前 | 説明 | 型 | 状態 |
|---|---|---|---|
| az desktopvirtualization hostpool create |
ホスト プールを作成する |
Extension | GA |
| az desktopvirtualization hostpool delete |
ホスト プールを削除します。 |
Extension | GA |
| az desktopvirtualization hostpool list |
ホスト プールを一覧表示します。 |
Extension | GA |
| az desktopvirtualization hostpool retrieve-registration-token |
ホスト プールの登録トークン。 |
Extension | GA |
| az desktopvirtualization hostpool show |
ホスト プールを表示します。 |
Extension | GA |
| az desktopvirtualization hostpool update |
ホスト プールを更新します。 |
Extension | GA |
az desktopvirtualization hostpool create
ホスト プールを作成する
az desktopvirtualization hostpool create --host-pool-type {BYODesktop, Personal, Pooled}
--load-balancer-type {BreadthFirst, DepthFirst, Persistent}
--name
--preferred-app-group-type {Desktop, None, RailApplications}
--resource-group
[--custom-rdp-property]
[--description]
[--friendly-name]
[--___location]
[--max-session-limit]
[--personal-desktop-assignment-type {Automatic, Direct}]
[--registration-info]
[--ring]
[--sso-client-id]
[--sso-client-secret-key-vault-path]
[--sso-secret-type {Certificate, CertificateInKeyVault, SharedKey, SharedKeyInKeyVault}]
[--ssoadfs-authority]
[--start-vm-on-connect {0, 1, f, false, n, no, t, true, y, yes}]
[--tags]
[--validation-environment {0, 1, f, false, n, no, t, true, y, yes}]
[--vm-template]
例
ホスト プールの作成
az desktopvirtualization hostpool create -g rg -n hostpool-name --friendly-name friendly --host-pool-type Pooled --load-balancer-type BreadthFirst --max-session-limit 999999 --personal-desktop-assignment-type Automatic --preferred-app-group-type Desktop --registration-info expiration-time="yyyy-mm-ddT08:38:08.189Z" registration-token-operation=Update --sso-client-id client --sso-client-secret-key-vault-path https://keyvault/secret --sso-secret-type SharedKey --start-vm-on-connect false
必須のパラメーター
デスクトップのホスト プールの種類。
| プロパティ | 値 |
|---|---|
| 指定可能な値: | BYODesktop, Personal, Pooled |
ロード バランサーの種類。
| プロパティ | 値 |
|---|---|
| 指定可能な値: | BreadthFirst, DepthFirst, Persistent |
指定したリソース グループ内のホスト プールの名前。
優先アプリケーション グループの種類。既定ではデスクトップ アプリケーション グループです。
| プロパティ | 値 |
|---|---|
| 指定可能な値: | Desktop, None, RailApplications |
リソース グループの名前。
az configure --defaults group=<name>を使用して既定のグループを構成できます。
省略可能のパラメーター
The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.
ホスト プールのカスタム rdp プロパティ。
HostPool の説明。
HostPool のフレンドリ名。
リソースが存在する地理的な場所。
HostPool の最大セッション制限。
HostPool の PersonalDesktopAssignment 型。
| プロパティ | 値 |
|---|---|
| 指定可能な値: | Automatic, Direct |
HostPool の登録情報。 短縮構文、json-file、yaml-file をサポートします。 詳細を表示するには、"??" を試してください。
HostPool のリング番号。
WVD SSO 証明書の発行に使用される登録済み証明書利用者の ClientId。
ADFS への通信に使用されるシークレットを格納する Azure KeyVault へのパス。
シークレットの種類に対するシングル サインオンの種類。
| プロパティ | 値 |
|---|---|
| 指定可能な値: | Certificate, CertificateInKeyVault, SharedKey, SharedKeyInKeyVault |
WVD SSO 証明書に署名するための顧客 ADFS サーバーへの URL。
StartVMOnConnect 機能のオン/オフを切り替えるフラグ。
| プロパティ | 値 |
|---|---|
| 指定可能な値: | 0, 1, f, false, n, no, t, true, y, yes |
リソース タグ。 短縮構文、json-file、yaml-file をサポートします。 詳細を表示するには、"??" を試してください。
検証環境です。
| プロパティ | 値 |
|---|---|
| 指定可能な値: | 0, 1, f, false, n, no, t, true, y, yes |
hostpool 内の sessionhosts 構成用の VM テンプレート。
グローバル パラメーター
ログの詳細度を上げて、すべてのデバッグ ログを表示します。
| プロパティ | 値 |
|---|---|
| 規定値: | False |
このヘルプ メッセージを表示して終了します。
エラーのみを表示し、警告を抑制します。
| プロパティ | 値 |
|---|---|
| 規定値: | False |
出力フォーマット。
| プロパティ | 値 |
|---|---|
| 規定値: | json |
| 指定可能な値: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ を参照してください。
サブスクリプションの名前または ID。
az account set -s NAME_OR_IDを使用して既定のサブスクリプションを構成できます。
ログの詳細度を高める。 完全なデバッグ ログには --debug を使用します。
| プロパティ | 値 |
|---|---|
| 規定値: | False |
az desktopvirtualization hostpool delete
ホスト プールを削除します。
az desktopvirtualization hostpool delete [--force {0, 1, f, false, n, no, t, true, y, yes}]
[--ids]
[--name]
[--resource-group]
[--subscription]
[--yes]
例
ホスト プールの削除
az desktopvirtualization hostpool delete -g rg -n hostpool-name
省略可能のパラメーター
The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.
sessionHost を強制的に削除するようにフラグを設定します。
| プロパティ | 値 |
|---|---|
| 指定可能な値: | 0, 1, f, false, n, no, t, true, y, yes |
1 つ以上のリソース ID (スペース区切り)。 これは、'Resource Id' 引数のすべての情報を含む完全なリソース ID である必要があります。 --ids または他の 'Resource Id' 引数を指定する必要があります。
| プロパティ | 値 |
|---|---|
| Parameter group: | Resource Id Arguments |
指定したリソース グループ内のホスト プールの名前。
| プロパティ | 値 |
|---|---|
| Parameter group: | Resource Id Arguments |
リソース グループの名前。
az configure --defaults group=<name>を使用して既定のグループを構成できます。
| プロパティ | 値 |
|---|---|
| Parameter group: | Resource Id Arguments |
サブスクリプションの名前または ID。
az account set -s NAME_OR_IDを使用して既定のサブスクリプションを構成できます。
| プロパティ | 値 |
|---|---|
| Parameter group: | Resource Id Arguments |
確認を求めないでください。
| プロパティ | 値 |
|---|---|
| 規定値: | False |
グローバル パラメーター
ログの詳細度を上げて、すべてのデバッグ ログを表示します。
| プロパティ | 値 |
|---|---|
| 規定値: | False |
このヘルプ メッセージを表示して終了します。
エラーのみを表示し、警告を抑制します。
| プロパティ | 値 |
|---|---|
| 規定値: | False |
出力フォーマット。
| プロパティ | 値 |
|---|---|
| 規定値: | json |
| 指定可能な値: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ を参照してください。
ログの詳細度を高める。 完全なデバッグ ログには --debug を使用します。
| プロパティ | 値 |
|---|---|
| 規定値: | False |
az desktopvirtualization hostpool list
ホスト プールを一覧表示します。
az desktopvirtualization hostpool list [--max-items]
[--next-token]
[--resource-group]
例
ホスト プールを一覧表示する
az desktopvirtualization hostpool list -g rg
省略可能のパラメーター
The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.
コマンドの出力で返される項目の合計数。 使用可能な項目の合計数が指定された値を超える場合は、コマンドの出力にトークンが提供されます。 改ページ位置の変更を再開するには、後続のコマンドの引数 --next-token トークン値を指定します。
| プロパティ | 値 |
|---|---|
| Parameter group: | Pagination Arguments |
ページ分割を開始する場所を指定するトークン。 これは、以前に切り捨てられた応答からのトークン値です。
| プロパティ | 値 |
|---|---|
| Parameter group: | Pagination Arguments |
リソース グループの名前。
az configure --defaults group=<name>を使用して既定のグループを構成できます。
グローバル パラメーター
ログの詳細度を上げて、すべてのデバッグ ログを表示します。
| プロパティ | 値 |
|---|---|
| 規定値: | False |
このヘルプ メッセージを表示して終了します。
エラーのみを表示し、警告を抑制します。
| プロパティ | 値 |
|---|---|
| 規定値: | False |
出力フォーマット。
| プロパティ | 値 |
|---|---|
| 規定値: | json |
| 指定可能な値: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ を参照してください。
サブスクリプションの名前または ID。
az account set -s NAME_OR_IDを使用して既定のサブスクリプションを構成できます。
ログの詳細度を高める。 完全なデバッグ ログには --debug を使用します。
| プロパティ | 値 |
|---|---|
| 規定値: | False |
az desktopvirtualization hostpool retrieve-registration-token
ホスト プールの登録トークン。
az desktopvirtualization hostpool retrieve-registration-token [--ids]
[--name]
[--resource-group]
[--subscription]
例
ホスト プールの登録トークン。
az desktopvirtualization hostpool retrieve-registration-token -n hostpool-name -g rg
省略可能のパラメーター
The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.
1 つ以上のリソース ID (スペース区切り)。 これは、'Resource Id' 引数のすべての情報を含む完全なリソース ID である必要があります。 --ids または他の 'Resource Id' 引数を指定する必要があります。
| プロパティ | 値 |
|---|---|
| Parameter group: | Resource Id Arguments |
指定したリソース グループ内のホスト プールの名前。
| プロパティ | 値 |
|---|---|
| Parameter group: | Resource Id Arguments |
リソース グループの名前。
az configure --defaults group=<name>を使用して既定のグループを構成できます。
| プロパティ | 値 |
|---|---|
| Parameter group: | Resource Id Arguments |
サブスクリプションの名前または ID。
az account set -s NAME_OR_IDを使用して既定のサブスクリプションを構成できます。
| プロパティ | 値 |
|---|---|
| Parameter group: | Resource Id Arguments |
グローバル パラメーター
ログの詳細度を上げて、すべてのデバッグ ログを表示します。
| プロパティ | 値 |
|---|---|
| 規定値: | False |
このヘルプ メッセージを表示して終了します。
エラーのみを表示し、警告を抑制します。
| プロパティ | 値 |
|---|---|
| 規定値: | False |
出力フォーマット。
| プロパティ | 値 |
|---|---|
| 規定値: | json |
| 指定可能な値: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ を参照してください。
ログの詳細度を高める。 完全なデバッグ ログには --debug を使用します。
| プロパティ | 値 |
|---|---|
| 規定値: | False |
az desktopvirtualization hostpool show
ホスト プールを表示します。
az desktopvirtualization hostpool show [--ids]
[--name]
[--resource-group]
[--subscription]
例
ホスト プールを表示する
az desktopvirtualization hostpool show -g rg -n hostpool-name
省略可能のパラメーター
The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.
1 つ以上のリソース ID (スペース区切り)。 これは、'Resource Id' 引数のすべての情報を含む完全なリソース ID である必要があります。 --ids または他の 'Resource Id' 引数を指定する必要があります。
| プロパティ | 値 |
|---|---|
| Parameter group: | Resource Id Arguments |
指定したリソース グループ内のホスト プールの名前。
| プロパティ | 値 |
|---|---|
| Parameter group: | Resource Id Arguments |
リソース グループの名前。
az configure --defaults group=<name>を使用して既定のグループを構成できます。
| プロパティ | 値 |
|---|---|
| Parameter group: | Resource Id Arguments |
サブスクリプションの名前または ID。
az account set -s NAME_OR_IDを使用して既定のサブスクリプションを構成できます。
| プロパティ | 値 |
|---|---|
| Parameter group: | Resource Id Arguments |
グローバル パラメーター
ログの詳細度を上げて、すべてのデバッグ ログを表示します。
| プロパティ | 値 |
|---|---|
| 規定値: | False |
このヘルプ メッセージを表示して終了します。
エラーのみを表示し、警告を抑制します。
| プロパティ | 値 |
|---|---|
| 規定値: | False |
出力フォーマット。
| プロパティ | 値 |
|---|---|
| 規定値: | json |
| 指定可能な値: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ を参照してください。
ログの詳細度を高める。 完全なデバッグ ログには --debug を使用します。
| プロパティ | 値 |
|---|---|
| 規定値: | False |
az desktopvirtualization hostpool update
ホスト プールを更新します。
az desktopvirtualization hostpool update [--add]
[--custom-rdp-property]
[--description]
[--force-string {0, 1, f, false, n, no, t, true, y, yes}]
[--friendly-name]
[--ids]
[--load-balancer-type {BreadthFirst, DepthFirst, Persistent}]
[--max-session-limit]
[--name]
[--personal-desktop-assignment-type {Automatic, Direct}]
[--preferred-app-group-type {Desktop, None, RailApplications}]
[--registration-info]
[--remove]
[--resource-group]
[--ring]
[--set]
[--sso-client-id]
[--sso-client-secret-key-vault-path]
[--sso-secret-type {Certificate, CertificateInKeyVault, SharedKey, SharedKeyInKeyVault}]
[--ssoadfs-authority]
[--start-vm-on-connect {0, 1, f, false, n, no, t, true, y, yes}]
[--subscription]
[--tags]
[--validation-environment {0, 1, f, false, n, no, t, true, y, yes}]
[--vm-template]
例
ホスト プールを更新する
az desktopvirtualization hostpool update -g rg -n hostpool-name --tags tag=test
省略可能のパラメーター
The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.
パスとキー値のペアを指定して、オブジェクトの一覧にオブジェクトを追加します。 例: --add property.listProperty <key=value, string or JSON string>。
| プロパティ | 値 |
|---|---|
| Parameter group: | Generic Update Arguments |
ホスト プールのカスタム rdp プロパティ。
HostPool の説明。
'set' または 'add' を使用する場合は、JSON に変換するのではなく、文字列リテラルを保持します。
| プロパティ | 値 |
|---|---|
| Parameter group: | Generic Update Arguments |
| 指定可能な値: | 0, 1, f, false, n, no, t, true, y, yes |
HostPool のフレンドリ名。
1 つ以上のリソース ID (スペース区切り)。 これは、'Resource Id' 引数のすべての情報を含む完全なリソース ID である必要があります。 --ids または他の 'Resource Id' 引数を指定する必要があります。
| プロパティ | 値 |
|---|---|
| Parameter group: | Resource Id Arguments |
ロード バランサーの種類。
| プロパティ | 値 |
|---|---|
| 指定可能な値: | BreadthFirst, DepthFirst, Persistent |
HostPool の最大セッション制限。
指定したリソース グループ内のホスト プールの名前。
| プロパティ | 値 |
|---|---|
| Parameter group: | Resource Id Arguments |
HostPool の PersonalDesktopAssignment 型。
| プロパティ | 値 |
|---|---|
| 指定可能な値: | Automatic, Direct |
優先アプリケーション グループの種類。既定ではデスクトップ アプリケーション グループです。
| プロパティ | 値 |
|---|---|
| 指定可能な値: | Desktop, None, RailApplications |
HostPool の登録情報。 短縮構文、json-file、yaml-file をサポートします。 詳細を表示するには、"??" を試してください。
リストからプロパティまたは要素を削除します。 例: --remove property.list <indexToRemove> OR --remove propertyToRemove。
| プロパティ | 値 |
|---|---|
| Parameter group: | Generic Update Arguments |
リソース グループの名前。
az configure --defaults group=<name>を使用して既定のグループを構成できます。
| プロパティ | 値 |
|---|---|
| Parameter group: | Resource Id Arguments |
HostPool のリング番号。
設定するプロパティ パスと値を指定して、オブジェクトを更新します。 例: --set property1.property2=<value>。
| プロパティ | 値 |
|---|---|
| Parameter group: | Generic Update Arguments |
WVD SSO 証明書の発行に使用される登録済み証明書利用者の ClientId。
ADFS への通信に使用されるシークレットを格納する Azure KeyVault へのパス。
シークレットの種類に対するシングル サインオンの種類。
| プロパティ | 値 |
|---|---|
| 指定可能な値: | Certificate, CertificateInKeyVault, SharedKey, SharedKeyInKeyVault |
WVD SSO 証明書に署名するための顧客 ADFS サーバーへの URL。
StartVMOnConnect 機能のオン/オフを切り替えるフラグ。
| プロパティ | 値 |
|---|---|
| 指定可能な値: | 0, 1, f, false, n, no, t, true, y, yes |
サブスクリプションの名前または ID。
az account set -s NAME_OR_IDを使用して既定のサブスクリプションを構成できます。
| プロパティ | 値 |
|---|---|
| Parameter group: | Resource Id Arguments |
リソース タグ。 短縮構文、json-file、yaml-file をサポートします。 詳細を表示するには、"??" を試してください。
検証環境です。
| プロパティ | 値 |
|---|---|
| 指定可能な値: | 0, 1, f, false, n, no, t, true, y, yes |
hostpool 内の sessionhosts 構成用の VM テンプレート。
グローバル パラメーター
ログの詳細度を上げて、すべてのデバッグ ログを表示します。
| プロパティ | 値 |
|---|---|
| 規定値: | False |
このヘルプ メッセージを表示して終了します。
エラーのみを表示し、警告を抑制します。
| プロパティ | 値 |
|---|---|
| 規定値: | False |
出力フォーマット。
| プロパティ | 値 |
|---|---|
| 規定値: | json |
| 指定可能な値: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ を参照してください。
ログの詳細度を高める。 完全なデバッグ ログには --debug を使用します。
| プロパティ | 値 |
|---|---|
| 規定値: | False |