你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

Virtual Machines - Run Command

在 VM 上运行命令。

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/virtualMachines/{vmName}/runCommand?api-version=2024-07-01

URI 参数

名称 必需 类型 说明
resourceGroupName
path True

string

资源组的名称。

subscriptionId
path True

string

唯一标识 azure 订阅Microsoft的订阅凭据。 订阅 ID 构成了每个服务调用的 URI 的一部分。

vmName
path True

string

虚拟机的名称。

api-version
query True

string

客户端 API 版本。

请求正文

Media Types: "application/json", "text/json"

名称 必需 类型 说明
commandId True

string

运行命令 ID。

parameters

RunCommandInputParameter[]

run 命令参数。

script

string[]

自选。 要执行的脚本。 给出此值后,给定脚本将替代命令的默认脚本。

响应

名称 类型 说明
200 OK

RunCommandResult

还行

Media Types: "application/json", "text/json"

202 Accepted

接受

Media Types: "application/json", "text/json"

安全性

azure_auth

Azure Active Directory OAuth2 Flow

类型: oauth2
流向: implicit
授权 URL: https://login.microsoftonline.com/common/oauth2/authorize

作用域

名称 说明
user_impersonation 模拟用户帐户

示例

VirtualMachineRunCommand

示例请求

POST https://management.azure.com/subscriptions/24fb23e3-6ba3-41f0-9b6e-e41131d5d61e/resourceGroups/crptestar98131/providers/Microsoft.Compute/virtualMachines/vm3036/runCommand?api-version=2024-07-01

{
  "commandId": "RunPowerShellScript"
}

示例响应

{
  "value": [
    {
      "code": "ComponentStatus/StdOut/succeeded",
      "level": "Info",
      "displayStatus": "Provisioning succeeded",
      "message": "This is a sample script with parameters value1 value2"
    },
    {
      "code": "ComponentStatus/StdErr/succeeded",
      "level": "Info",
      "displayStatus": "Provisioning succeeded",
      "message": ""
    }
  ]
}
Location: https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Compute/locations/westus/operations/{operationId}&monitor=true&api-version=2024-07-01

定义

名称 说明
InstanceViewStatus

实例视图状态。

RunCommandInput

捕获虚拟机参数。

RunCommandInputParameter

描述 run 命令参数的属性。

RunCommandResult
StatusLevelTypes

级别代码。

InstanceViewStatus

实例视图状态。

名称 类型 说明
code

string

状态代码。

displayStatus

string

状态的简短可本地化标签。

level

StatusLevelTypes

级别代码。

message

string

详细状态消息,包括警报和错误消息。

time

string

状态的时间。

RunCommandInput

捕获虚拟机参数。

名称 类型 说明
commandId

string

运行命令 ID。

parameters

RunCommandInputParameter[]

run 命令参数。

script

string[]

自选。 要执行的脚本。 给出此值后,给定脚本将替代命令的默认脚本。

RunCommandInputParameter

描述 run 命令参数的属性。

名称 类型 说明
name

string

run 命令参数名称。

value

string

run 命令参数值。

RunCommandResult

名称 类型 说明
value

InstanceViewStatus[]

运行命令操作响应。

StatusLevelTypes

级别代码。

名称 类型 说明
Error

string

Info

string

Warning

string