Microsoft.Compute virtualMachines/runCommands 2022-11-01
Bicep-Ressourcendefinition
Der Ressourcentyp virtualMachines/runCommands kann mit Vorgängen bereitgestellt werden, die auf Folgendes abzielen:
- Ressourcengruppen – Siehe Bereitstellungsbefehle für Ressourcengruppen
Eine Liste der geänderten Eigenschaften in jeder API-Version finden Sie im Änderungsprotokoll.
Ressourcenformat
Um eine Microsoft.Compute/virtualMachines/runCommands-Ressource zu erstellen, fügen Sie der Vorlage den folgenden Bicep hinzu.
resource symbolicname 'Microsoft.Compute/virtualMachines/runCommands@2022-11-01' = {
name: 'string'
location: 'string'
tags: {
tagName1: 'tagValue1'
tagName2: 'tagValue2'
}
parent: resourceSymbolicName
properties: {
asyncExecution: bool
errorBlobUri: 'string'
outputBlobUri: 'string'
parameters: [
{
name: 'string'
value: 'string'
}
]
protectedParameters: [
{
name: 'string'
value: 'string'
}
]
runAsPassword: 'string'
runAsUser: 'string'
source: {
commandId: 'string'
script: 'string'
scriptUri: 'string'
}
timeoutInSeconds: int
}
}
Eigenschaftswerte
virtualMachines/runCommands
Name | BESCHREIBUNG | Wert |
---|---|---|
name | Der Ressourcenname Weitere Informationen finden Sie unter Festlegen von Namen und Typen für untergeordnete Ressourcen in Bicep. |
Zeichenfolge (erforderlich) |
location | Ressourcenspeicherort | Zeichenfolge (erforderlich) |
tags | Ressourcentags | Wörterbuch der Tagnamen und -werte. Weitere Informationen finden Sie unter Tags in Vorlagen. |
parent | In Bicep können Sie die übergeordnete Ressource für eine untergeordnete Ressource angeben. Sie müssen diese Eigenschaft nur hinzufügen, wenn die untergeordnete Ressource außerhalb der übergeordneten Ressource deklariert wird. Weitere Informationen finden Sie unter Untergeordnete Ressource außerhalb der übergeordneten Ressource. |
Symbolischer Name für Ressource vom Typ : virtualMachines |
properties | Beschreibt die Eigenschaften eines Vm-Ausführungsbefehls. | VirtualMachineRunCommandProperties |
VirtualMachineRunCommandProperties
Name | BESCHREIBUNG | Wert |
---|---|---|
asyncExecution | Optional. Wenn dieser Wert auf TRUE festgelegt ist, wird die Bereitstellung abgeschlossen, sobald das Skript gestartet wird, und es wird nicht auf den Abschluss des Skripts gewartet. | bool |
errorBlobUri | Gibt das Azure Storage-Blob an, in das der Skriptfehlerstream hochgeladen wird. | Zeichenfolge |
outputBlobUri | Gibt das Azure Storage-Blob an, in das der Skriptausgabestream hochgeladen wird. | Zeichenfolge |
parameters | Die vom Skript verwendeten Parameter. | RunCommandInputParameter[] |
protectedParameters | Die vom Skript verwendeten Parameter. | RunCommandInputParameter[] |
runAsPassword | Gibt das Benutzerkontokennwort auf dem virtuellen Computer an, wenn der Befehl run ausgeführt wird. | Zeichenfolge |
runAsUser | Gibt das Benutzerkonto auf dem virtuellen Computer an, wenn der Befehl run ausgeführt wird. | Zeichenfolge |
source | Die Quelle des Ausführungsbefehlsskripts. | VirtualMachineRunCommandScriptSource |
timeoutInSeconds | Das Timeout in Sekunden zum Ausführen des Ausführungsbefehls. | INT |
RunCommandInputParameter
Name | BESCHREIBUNG | Wert |
---|---|---|
name | Der Name des Run-Befehlsparameters. | Zeichenfolge (erforderlich) |
value | Der Wert des Befehlsparameters run. | Zeichenfolge (erforderlich) |
VirtualMachineRunCommandScriptSource
Name | BESCHREIBUNG | Wert |
---|---|---|
commandId | Gibt eine commandId des vordefinierten integrierten Skripts an. | Zeichenfolge |
script | Gibt den Skriptinhalt an, der auf dem virtuellen Computer ausgeführt werden soll. | Zeichenfolge |
scriptUri | Gibt den Speicherort für den Skriptdownload an. | Zeichenfolge |
Schnellstartvorlagen
Diesen Ressourcentyp werden in den folgenden Schnellstartvorlagen bereitgestellt.
Vorlage | BESCHREIBUNG |
---|---|
SharePoint-Abonnement / 2019 / 2016 / 2013 alle konfiguriert |
Mit dieser Vorlage wird eine SharePoint-Abonnementfarm /2019/2016/2013 mit einer umfangreichen Konfiguration erstellt, die eine manuelle Ausführung dauern würde, einschließlich einer Verbundauthentifizierung mit ADFS, einer OAuth-Vertrauensstellung, dem Benutzerprofildienst und einer Webanwendung mit 2 Zonen, die mehrere pfadbasierte und hostnamenbasierte Websitesammlungen enthält. Auf den virtuellen SharePoint-Computern wird Chocolatey verwendet, um die neueste Version von Notepad++, Visual Studio Code, Azure Data Studio, Fiddler, ULS Viewer und 7-Zip zu installieren. |
Ressourcendefinition mit einer ARM-Vorlage
Der Ressourcentyp virtualMachines/runCommands kann mit Vorgängen bereitgestellt werden, die Folgendes zum Ziel haben:
- Ressourcengruppen : Siehe Ressourcengruppenbereitstellungsbefehle
Eine Liste der geänderten Eigenschaften in jeder API-Version finden Sie unter Änderungsprotokoll.
Ressourcenformat
Um eine Microsoft.Compute/virtualMachines/runCommands-Ressource zu erstellen, fügen Sie der Vorlage den folgenden JSON-Code hinzu.
{
"type": "Microsoft.Compute/virtualMachines/runCommands",
"apiVersion": "2022-11-01",
"name": "string",
"location": "string",
"tags": {
"tagName1": "tagValue1",
"tagName2": "tagValue2"
},
"properties": {
"asyncExecution": "bool",
"errorBlobUri": "string",
"outputBlobUri": "string",
"parameters": [
{
"name": "string",
"value": "string"
}
],
"protectedParameters": [
{
"name": "string",
"value": "string"
}
],
"runAsPassword": "string",
"runAsUser": "string",
"source": {
"commandId": "string",
"script": "string",
"scriptUri": "string"
},
"timeoutInSeconds": "int"
}
}
Eigenschaftswerte
virtualMachines/runCommands
Name | BESCHREIBUNG | Wert |
---|---|---|
type | Ressourcentyp | "Microsoft.Compute/virtualMachines/runCommands" |
apiVersion | Die Ressourcen-API-Version | '2022-11-01' |
name | Der Ressourcenname Erfahren Sie, wie Sie Namen und Typen für untergeordnete Ressourcen in JSON-ARM-Vorlagen festlegen. |
Zeichenfolge (erforderlich) |
location | Ressourcenspeicherort | Zeichenfolge (erforderlich) |
tags | Ressourcentags | Wörterbuch der Tagnamen und -werte. Siehe Tags in Vorlagen |
properties | Beschreibt die Eigenschaften eines Vm-Ausführungsbefehls. | VirtualMachineRunCommandProperties |
VirtualMachineRunCommandProperties
Name | BESCHREIBUNG | Wert |
---|---|---|
asyncExecution | Optional. Wenn true festgelegt ist, wird die Bereitstellung abgeschlossen, sobald das Skript gestartet wird, und wartet nicht auf den Abschluss des Skripts. | bool |
errorBlobUri | Gibt das Azure-Speicherblob an, in das der Skriptfehlerstream hochgeladen wird. | Zeichenfolge |
outputBlobUri | Gibt das Azure Storage-Blob an, in das der Skriptausgabestream hochgeladen wird. | Zeichenfolge |
parameters | Die vom Skript verwendeten Parameter. | RunCommandInputParameter[] |
protectedParameters | Die vom Skript verwendeten Parameter. | RunCommandInputParameter[] |
runAsPassword | Gibt das Benutzerkontokennwort auf dem virtuellen Computer an, wenn der Befehl "ausführen" ausgeführt wird. | Zeichenfolge |
runAsUser | Gibt das Benutzerkonto auf dem virtuellen Computer an, wenn der Ausführungsbefehl ausgeführt wird. | Zeichenfolge |
source | Die Quelle des Ausführungsbefehlsskripts. | VirtualMachineRunCommandScriptSource |
timeoutInSeconds | Das Timeout in Sekunden, um den Befehl ausführen zu können. | INT |
RunCommandInputParameter
Name | BESCHREIBUNG | Wert |
---|---|---|
name | Der Name des Befehlsparameters ausführen. | Zeichenfolge (erforderlich) |
value | Der Wert des Befehlsparameters ausführen. | Zeichenfolge (erforderlich) |
VirtualMachineRunCommandScriptSource
Name | BESCHREIBUNG | Wert |
---|---|---|
commandId | Gibt eine CommandId des vordefinierten integrierten Skripts an. | Zeichenfolge |
script | Gibt den Skriptinhalt an, der auf dem virtuellen Computer ausgeführt werden soll. | Zeichenfolge |
scriptUri | Gibt den Speicherort für den Skriptdownload an. | Zeichenfolge |
Schnellstartvorlagen
Diesen Ressourcentyp werden in den folgenden Schnellstartvorlagen bereitgestellt.
Vorlage | BESCHREIBUNG |
---|---|
SharePoint-Abonnement / 2019 / 2016 / 2013 alle konfiguriert |
Mit dieser Vorlage wird eine SharePoint-Abonnementfarm /2019/2016/2013 mit einer umfangreichen Konfiguration erstellt, die eine manuelle Ausführung dauern würde, einschließlich einer Verbundauthentifizierung mit ADFS, einer OAuth-Vertrauensstellung, dem Benutzerprofildienst und einer Webanwendung mit 2 Zonen, die mehrere pfadbasierte und hostnamenbasierte Websitesammlungen enthält. Auf den virtuellen SharePoint-Computern wird Chocolatey verwendet, um die neueste Version von Notepad++, Visual Studio Code, Azure Data Studio, Fiddler, ULS Viewer und 7-Zip zu installieren. |
Terraform (AzAPI-Anbieter) Ressourcendefinition
Der Ressourcentyp virtualMachines/runCommands kann mit Vorgängen bereitgestellt werden, die Folgendes zum Ziel haben:
- Ressourcengruppen
Eine Liste der geänderten Eigenschaften in jeder API-Version finden Sie unter Änderungsprotokoll.
Ressourcenformat
Um eine Microsoft.Compute/virtualMachines/runCommands-Ressource zu erstellen, fügen Sie der Vorlage die folgende Terraform-Ressource hinzu.
resource "azapi_resource" "symbolicname" {
type = "Microsoft.Compute/virtualMachines/runCommands@2022-11-01"
name = "string"
location = "string"
parent_id = "string"
tags = {
tagName1 = "tagValue1"
tagName2 = "tagValue2"
}
body = jsonencode({
properties = {
asyncExecution = bool
errorBlobUri = "string"
outputBlobUri = "string"
parameters = [
{
name = "string"
value = "string"
}
]
protectedParameters = [
{
name = "string"
value = "string"
}
]
runAsPassword = "string"
runAsUser = "string"
source = {
commandId = "string"
script = "string"
scriptUri = "string"
}
timeoutInSeconds = int
}
})
}
Eigenschaftswerte
virtualMachines/runCommands
Name | BESCHREIBUNG | Wert |
---|---|---|
type | Ressourcentyp | "Microsoft.Compute/virtualMachines/runCommands@2022-11-01" |
name | Der Ressourcenname | Zeichenfolge (erforderlich) |
location | Ressourcenspeicherort | Zeichenfolge (erforderlich) |
parent_id | Die ID der Ressource, die die übergeordnete Ressource für diese Ressource ist. | ID für Ressource vom Typ : virtualMachines |
tags | Ressourcentags | Wörterbuch der Tagnamen und -werte. |
properties | Beschreibt die Eigenschaften eines Vm-Ausführungsbefehls. | VirtualMachineRunCommandProperties |
VirtualMachineRunCommandProperties
Name | BESCHREIBUNG | Wert |
---|---|---|
asyncExecution | Optional. Wenn true festgelegt ist, wird die Bereitstellung abgeschlossen, sobald das Skript gestartet wird, und wartet nicht auf den Abschluss des Skripts. | bool |
errorBlobUri | Gibt das Azure-Speicherblob an, in das der Skriptfehlerstream hochgeladen wird. | Zeichenfolge |
outputBlobUri | Gibt das Azure Storage-Blob an, in das der Skriptausgabestream hochgeladen wird. | Zeichenfolge |
parameters | Die vom Skript verwendeten Parameter. | RunCommandInputParameter[] |
protectedParameters | Die vom Skript verwendeten Parameter. | RunCommandInputParameter[] |
runAsPassword | Gibt das Benutzerkontokennwort auf dem virtuellen Computer an, wenn der Befehl "ausführen" ausgeführt wird. | Zeichenfolge |
runAsUser | Gibt das Benutzerkonto auf dem virtuellen Computer an, wenn der Ausführungsbefehl ausgeführt wird. | Zeichenfolge |
source | Die Quelle des Ausführungsbefehlsskripts. | VirtualMachineRunCommandScriptSource |
timeoutInSeconds | Das Timeout in Sekunden, um den Befehl ausführen zu können. | INT |
RunCommandInputParameter
Name | BESCHREIBUNG | Wert |
---|---|---|
name | Der Name des Befehlsparameters ausführen. | Zeichenfolge (erforderlich) |
value | Der Wert des Befehlsparameters ausführen. | Zeichenfolge (erforderlich) |
VirtualMachineRunCommandScriptSource
Name | BESCHREIBUNG | Wert |
---|---|---|
commandId | Gibt eine CommandId des vordefinierten integrierten Skripts an. | Zeichenfolge |
script | Gibt den Skriptinhalt an, der auf dem virtuellen Computer ausgeführt werden soll. | Zeichenfolge |
scriptUri | Gibt den Speicherort für den Skriptdownload an. | Zeichenfolge |
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für