共用方式為


VirtualMachineRunCommand 類別

描述虛擬機器執行命令。

變數只會由伺服器填入,而且會在傳送要求時予以忽略。

必須填入所有必要的參數,才能傳送至 Azure。

繼承
azure.mgmt.compute.v2023_09_01.models._models_py3.Resource
VirtualMachineRunCommand

建構函式

VirtualMachineRunCommand(*, location: str, tags: Dict[str, str] | None = None, source: _models.VirtualMachineRunCommandScriptSource | None = None, parameters: List[_models.RunCommandInputParameter] | None = None, protected_parameters: List[_models.RunCommandInputParameter] | None = None, async_execution: bool = False, run_as_user: str | None = None, run_as_password: str | None = None, timeout_in_seconds: int | None = None, output_blob_uri: str | None = None, error_blob_uri: str | None = None, output_blob_managed_identity: _models.RunCommandManagedIdentity | None = None, error_blob_managed_identity: _models.RunCommandManagedIdentity | None = None, treat_failure_as_deployment_failure: bool = False, **kwargs: Any)

Keyword-Only Parameters

location
str

資源位置。 必要。

tags
dict[str, str]

資源標籤。

source
VirtualMachineRunCommandScriptSource

執行命令腳本的來源。

parameters
list[RunCommandInputParameter]

腳本所使用的參數。

protected_parameters
list[RunCommandInputParameter]

腳本所使用的參數。

async_execution
bool

選擇性。 如果設定為 true,布建會在腳本啟動時立即完成,且不會等待腳本完成。

run_as_user
str

在執行執行命令時,指定 VM 上的使用者帳戶。

run_as_password
str

在執行執行命令時,指定 VM 上的使用者帳戶密碼。

timeout_in_seconds
int

執行執行命令的逾時以秒為單位。

output_blob_uri
str

指定將上傳腳本輸出資料流程的 Azure 儲存體 Blob。 使用 SAS URI 搭配讀取、附加、建立、寫入存取或使用受控識別來提供 Blob 的 VM 存取權。 請參閱 outputBlobManagedIdentity 參數。

error_blob_uri
str

指定將上傳腳本錯誤資料流程的 Azure 儲存體 Blob。 使用 SAS URI 搭配讀取、附加、建立、寫入存取或使用受控識別來提供 Blob 的 VM 存取權。 請參閱 errorBlobManagedIdentity 參數。

output_blob_managed_identity
RunCommandManagedIdentity

使用者指派的受控識別,可存取 outputBlobUri 儲存體 Blob。 如果是系統指派的身分識別,請使用空白物件。 請確定受控識別已獲得 Blob 容器的存取權,並具有「儲存體 Blob 資料參與者」角色指派。 如果是使用者指派的身分識別,請務必在 VM 的身分識別下新增。 如需受控識別和執行命令的詳細資訊,請參閱 https://aka.ms/ManagedIdentityhttps://aka.ms/RunCommandManaged

error_blob_managed_identity
RunCommandManagedIdentity

使用者指派的受控識別,可存取 errorBlobUri 儲存體 Blob。 如果是系統指派的身分識別,請使用空白物件。 請確定受控識別已獲得 Blob 容器的存取權,並具有「儲存體 Blob 資料參與者」角色指派。 如果是使用者指派的身分識別,請務必在 VM 的身分識別下新增。 如需受控識別和執行命令的詳細資訊,請參閱 https://aka.ms/ManagedIdentityhttps://aka.ms/RunCommandManaged

treat_failure_as_deployment_failure
bool

選擇性。 如果設定為 true,腳本中的任何失敗都會失敗部署,且 ProvisioningState 會標示為失敗。 如果設定為 false,ProvisioningState 只會反映執行命令是否由延伸模組平臺執行,它不會指出腳本在腳本失敗時是否失敗。 查看執行命令的實例檢視,以防腳本失敗,以查看 executionMessage、output、error: https://aka.ms/runcommandmanaged#get-execution-status-and-results

變數

id
str

資源識別碼。

name
str

資源名稱。

type
str

資源類型。

location
str

資源位置。 必要。

tags
dict[str, str]

資源標籤。

source
VirtualMachineRunCommandScriptSource

執行命令腳本的來源。

parameters
list[RunCommandInputParameter]

腳本所使用的參數。

protected_parameters
list[RunCommandInputParameter]

腳本所使用的參數。

async_execution
bool

選擇性。 如果設定為 true,布建會在腳本啟動時立即完成,且不會等待腳本完成。

run_as_user
str

在執行執行命令時,指定 VM 上的使用者帳戶。

run_as_password
str

在執行執行命令時,指定 VM 上的使用者帳戶密碼。

timeout_in_seconds
int

執行執行命令的逾時以秒為單位。

output_blob_uri
str

指定將上傳腳本輸出資料流程的 Azure 儲存體 Blob。 使用 SAS URI 搭配讀取、附加、建立、寫入存取或使用受控識別來提供 Blob 的 VM 存取權。 請參閱 outputBlobManagedIdentity 參數。

error_blob_uri
str

指定將上傳腳本錯誤資料流程的 Azure 儲存體 Blob。 使用 SAS URI 搭配讀取、附加、建立、寫入存取或使用受控識別來提供 Blob 的 VM 存取權。 請參閱 errorBlobManagedIdentity 參數。

output_blob_managed_identity
RunCommandManagedIdentity

使用者指派的受控識別,可存取 outputBlobUri 儲存體 Blob。 如果是系統指派的身分識別,請使用空白物件。 請確定受控識別已獲得 Blob 容器的存取權,並具有「儲存體 Blob 資料參與者」角色指派。 如果是使用者指派的身分識別,請務必在 VM 的身分識別下新增。 如需受控識別和執行命令的詳細資訊,請參閱 https://aka.ms/ManagedIdentityhttps://aka.ms/RunCommandManaged

error_blob_managed_identity
RunCommandManagedIdentity

使用者指派的受控識別,可存取 errorBlobUri 儲存體 Blob。 如果是系統指派的身分識別,請使用空白物件。 請確定受控識別已獲得 Blob 容器的存取權,並具有「儲存體 Blob 資料參與者」角色指派。 如果是使用者指派的身分識別,請務必在 VM 的身分識別下新增。 如需受控識別和執行命令的詳細資訊,請參閱 https://aka.ms/ManagedIdentityhttps://aka.ms/RunCommandManaged

provisioning_state
str

布建狀態,只會出現在回應中。 如果 treatFailureAsDeploymentFailure 設為 true,腳本中的任何失敗都會失敗部署,且 ProvisioningState 會標示為失敗。 如果 treatFailureAsDeploymentFailure 設定為 false,ProvisioningState 只會反映執行命令是否由延伸模組平臺執行,它不會指出腳本在腳本失敗時是否失敗。 查看執行命令的實例檢視,以防腳本失敗,以查看 executionMessage、output、error: https://aka.ms/runcommandmanaged#get-execution-status-and-results

instance_view
VirtualMachineRunCommandInstanceView

虛擬機器執行命令實例檢視。

treat_failure_as_deployment_failure
bool

選擇性。 如果設定為 true,腳本中的任何失敗都會失敗部署,且 ProvisioningState 會標示為失敗。 如果設定為 false,ProvisioningState 只會反映執行命令是否由延伸模組平臺執行,它不會指出腳本在腳本失敗時是否失敗。 查看執行命令的實例檢視,以防腳本失敗,以查看 executionMessage、output、error: https://aka.ms/runcommandmanaged#get-execution-status-and-results