az batch node user

管理 Batch 計算節點的使用者帳戶。

命令

名稱	Description	類型	狀態
az batch node user create	將使用者帳戶新增至 Batch 計算節點。	核心	GA
az batch node user delete	從指定的計算節點刪除使用者帳戶。	核心	GA
az batch node user reset	更新 Batch 計算節點上使用者帳戶的屬性。 可以更新的未指定屬性會重設為預設值。	核心	GA

az batch node user create

將使用者帳戶新增至 Batch 計算節點。

az batch node user create --node-id
                          --pool-id
                          [--account-endpoint]
                          [--account-key]
                          [--account-name]
                          [--expiry-time]
                          [--is-admin]
                          [--json-file]
                          [--name]
                          [--password]
                          [--ssh-public-key]

必要參數

--node-id

您要在其中建立使用者帳戶之電腦的識別碼。

--pool-id

包含計算節點的集區識別碼。

選擇性參數

--account-endpoint

Batch 服務端點。 或者，由環境變數設定：AZURE_BATCH_ENDPOINT。

--account-key

Batch 帳戶金鑰。 或者，由環境變數設定：AZURE_BATCH_ACCESS_KEY。

--account-name

Batch 帳戶名稱。 或者，由環境變數設定：AZURE_BATCH_ACCOUNT。

--expiry-time

如果省略，預設值為從目前時間起的 1 天。 針對 Linux 計算節點，expiryTime 的精確度最多可達一天。 預期的格式是 ISO-8601 時間戳記。

--is-admin

帳戶是否應該是計算節點上的系統管理員。 預設值為 false。 如果旗標存在，則為 True。

--json-file

包含 JSON 中使用者規格的檔案（格式化為符合個別 REST API 主體）。 如果指定此參數，則會忽略所有 'User Arguments'。

--name

必要。

--password

Windows 計算節點需要密碼（使用 'cloudServiceConfiguration' 建立的密碼，或使用 Windows 映像參考以 'virtualMachineConfiguration' 建立的節點）。 針對 Linux 計算節點，可以選擇性地指定密碼以及 sshPublicKey 屬性。

--ssh-public-key

公開金鑰應該與 OpenSSH 編碼相容，而且應該以 64 為基底編碼。 此屬性只能針對 Linux 計算節點指定。 如果這是針對 Windows 計算節點指定的，則 Batch 服務會拒絕要求;如果您直接呼叫 REST API，則 HTTP 狀態碼為 400 （不正確的要求）。

全域參數

--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

預設值: json

--query

JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID 帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az batch node user delete

從指定的計算節點刪除使用者帳戶。

只有當使用者帳戶處於閒置或執行中狀態時，才可以將使用者帳戶刪除至計算節點。

az batch node user delete --node-id
                          --pool-id
                          --user-name
                          [--account-endpoint]
                          [--account-key]
                          [--account-name]
                          [--yes]

必要參數

--node-id

您要刪除使用者帳戶之電腦的識別碼。

--pool-id

包含計算節點的集區識別碼。

--user-name

要刪除的使用者帳戶名稱。

選擇性參數

--account-endpoint

Batch 服務端點。 或者，由環境變數設定：AZURE_BATCH_ENDPOINT。

--account-key

Batch 帳戶金鑰。 或者，由環境變數設定：AZURE_BATCH_ACCESS_KEY。

--account-name

Batch 帳戶名稱。 或者，由環境變數設定：AZURE_BATCH_ACCOUNT。

--yes -y

不提示確認。

預設值: False

全域參數

--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

預設值: json

--query

JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID 帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az batch node user reset

更新 Batch 計算節點上使用者帳戶的屬性。 可以更新的未指定屬性會重設為預設值。

az batch node user reset --node-id
                         --pool-id
                         --user-name
                         [--account-endpoint]
                         [--account-key]
                         [--account-name]
                         [--expiry-time]
                         [--json-file]
                         [--password]
                         [--ssh-public-key]

必要參數

--node-id

您要更新使用者帳戶之電腦的識別碼。

--pool-id

包含計算節點的集區識別碼。

--user-name

要更新的使用者帳戶名稱。

選擇性參數

--account-endpoint

Batch 服務端點。 或者，由環境變數設定：AZURE_BATCH_ENDPOINT。

--account-key

Batch 帳戶金鑰。 或者，由環境變數設定：AZURE_BATCH_ACCESS_KEY。

--account-name

Batch 帳戶名稱。 或者，由環境變數設定：AZURE_BATCH_ACCOUNT。

--expiry-time

如果省略，預設值為從目前時間起的 1 天。 針對 Linux 計算節點，expiryTime 的精確度最多可達一天。 預期的格式是 ISO-8601 時間戳記。

--json-file

檔案，其中包含 JSON 中的節點更新使用者參數規格（格式化以符合個別的 REST API 主體）。 如果指定此參數，則會忽略所有「節點更新使用者引數」。

--password

Windows 計算節點需要密碼（使用 'cloudServiceConfiguration' 建立的密碼，或使用 Windows 映像參考以 'virtualMachineConfiguration' 建立的節點）。 針對 Linux 計算節點，可以選擇性地指定密碼以及 sshPublicKey 屬性。 如果省略，則會移除任何現有的密碼。

--ssh-public-key

公開金鑰應該與 OpenSSH 編碼相容，而且應該以 64 為基底編碼。 此屬性只能針對 Linux 計算節點指定。 如果這是針對 Windows 計算節點指定的，則 Batch 服務會拒絕要求;如果您直接呼叫 REST API，則 HTTP 狀態碼為 400 （不正確的要求）。 如果省略，則會移除任何現有的 SSH 公開金鑰。

全域參數

--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

預設值: json

--query

JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID 帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。