Virtual Machines - Run Command
Voer de opdracht uit op de virtuele machine.
POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/virtualMachines/{vmName}/runCommand?api-version=2024-07-01
URI-parameters
Name | In | Vereist | Type | Description |
---|---|---|---|---|
resource
|
path | True |
string |
De naam van de resourcegroep. |
subscription
|
path | True |
string |
Abonnementsreferenties die het Microsoft Azure-abonnement uniek identificeren. De abonnements-id maakt deel uit van de URI voor elke serviceoproep. |
vm
|
path | True |
string |
De naam van de virtuele machine. |
api-version
|
query | True |
string |
Client-API-versie. |
Aanvraagbody
Media Types: "application/json", "text/json"
Name | Vereist | Type | Description |
---|---|---|---|
commandId | True |
string |
De opdracht-id uitvoeren. |
parameters |
De opdrachtparameters uitvoeren. |
||
script |
string[] |
Facultatief. Het script dat moet worden uitgevoerd. Wanneer deze waarde wordt opgegeven, overschrijft het opgegeven script het standaardscript van de opdracht. |
Antwoorden
Name | Type | Description |
---|---|---|
200 OK |
OK Media Types: "application/json", "text/json" |
|
202 Accepted |
Geaccepteerd Media Types: "application/json", "text/json" |
Beveiliging
azure_auth
Azure Active Directory OAuth2-stroom
Type:
oauth2
Stroom:
implicit
Autorisatie-URL:
https://login.microsoftonline.com/common/oauth2/authorize
Bereiken
Name | Description |
---|---|
user_impersonation | Uw gebruikersaccount imiteren |
Voorbeelden
VirtualMachineRunCommand
Voorbeeldaanvraag
Voorbeeldrespons
{
"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
Definities
Name | Description |
---|---|
Instance |
Status van exemplaarweergave. |
Run |
Parameters voor virtuele machines vastleggen. |
Run |
Beschrijft de eigenschappen van een opdrachtparameter uitvoeren. |
Run |
|
Status |
De niveaucode. |
InstanceViewStatus
Status van exemplaarweergave.
Name | Type | Description |
---|---|---|
code |
string |
De statuscode. |
displayStatus |
string |
Het korte lokaliseerbare label voor de status. |
level |
De niveaucode. |
|
message |
string |
Het gedetailleerde statusbericht, inclusief voor waarschuwingen en foutberichten. |
time |
string |
Het tijdstip van de status. |
RunCommandInput
Parameters voor virtuele machines vastleggen.
Name | Type | Description |
---|---|---|
commandId |
string |
De opdracht-id uitvoeren. |
parameters |
De opdrachtparameters uitvoeren. |
|
script |
string[] |
Facultatief. Het script dat moet worden uitgevoerd. Wanneer deze waarde wordt opgegeven, overschrijft het opgegeven script het standaardscript van de opdracht. |
RunCommandInputParameter
Beschrijft de eigenschappen van een opdrachtparameter uitvoeren.
Name | Type | Description |
---|---|---|
name |
string |
De parameternaam van de run-opdracht. |
value |
string |
De parameterwaarde van de opdracht uitvoeren. |
RunCommandResult
Name | Type | Description |
---|---|---|
value |
Voer het antwoord van de opdrachtbewerking uit. |
StatusLevelTypes
De niveaucode.
Name | Type | Description |
---|---|---|
Error |
string |
|
Info |
string |
|
Warning |
string |