Microsoft.Compute/virtualMachines/runCommands 2024-03-01 - Bicep, ARM template & Terraform AzAPI reference

Bicep-Ressourcendefinition

Der Ressourcentyp "virtualMachines/runCommands" kann mit Vorgängen bereitgestellt werden, die auf Folgendes abzielen:

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 die folgende Bicep hinzu.

resource symbolicname 'Microsoft.Compute/virtualMachines/runCommands@2024-03-01' = {
  name: 'string'
  location: 'string'
  tags: {
    tagName1: 'tagValue1'
    tagName2: 'tagValue2'
  }
  parent: resourceSymbolicName
  properties: {
    asyncExecution: bool
    errorBlobManagedIdentity: {
      clientId: 'string'
      objectId: 'string'
    }
    errorBlobUri: 'string'
    outputBlobManagedIdentity: {
      clientId: 'string'
      objectId: 'string'
    }
    outputBlobUri: 'string'
    parameters: [
      {
        name: 'string'
        value: 'string'
      }
    ]
    protectedParameters: [
      {
        name: 'string'
        value: 'string'
      }
    ]
    runAsPassword: 'string'
    runAsUser: 'string'
    source: {
      commandId: 'string'
      script: 'string'
      scriptUri: 'string'
      scriptUriManagedIdentity: {
        clientId: 'string'
        objectId: 'string'
      }
    }
    timeoutInSeconds: int
    treatFailureAsDeploymentFailure: bool
  }
}

Eigenschaftswerte

virtualMachines/runCommands

Name	Beschreibung	Wert
Name	Der Ressourcenname Erfahren Sie, wie Sie Namen und Typen für untergeordnete Ressourcen in Bicep-festlegen.	Zeichenfolge (erforderlich)
Ort	Ressourcenspeicherort	Zeichenfolge (erforderlich)
Schilder	Ressourcentags	Wörterbuch der Tagnamen und -werte. Siehe Tags in Vorlagen
Elternteil	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 des Typs: virtualMachines
Eigenschaften	Beschreibt die Eigenschaften eines Befehls zum Ausführen eines virtuellen Computers.	VirtualMachineRunCommandProperties

VirtualMachineRunCommandProperties

Name	Beschreibung	Wert
asyncExecution	Wahlfrei. Wenn "true" festgelegt ist, wird die Bereitstellung abgeschlossen, sobald das Skript gestartet wird und nicht auf den Abschluss des Skripts wartet.	Bool
errorBlobManagedIdentity	Vom Benutzer zugewiesene verwaltete Identität, die Zugriff auf den FehlerBlobUri-Speicherblob hat. Verwenden Sie ein leeres Objekt im Fall der vom System zugewiesenen Identität. Stellen Sie sicher, dass der Container eines Blobs mit der Rollenzuweisung "Storage Blob Data Contributor" auf verwaltete Identität zugreifen konnte. Stellen Sie bei der vom Benutzer zugewiesenen Identität sicher, dass Sie sie unter der Identität des virtuellen Computers hinzufügen. Weitere Informationen zu verwalteter Identität und Befehl ausführen finden Sie unter `https://aka.ms/ManagedIdentity` und `https://aka.ms/RunCommandManaged`	RunCommandManagedIdentity-
errorBlobUri	Gibt das Azure Storage-Blob an, bei dem der Skriptfehlerdatenstrom hochgeladen wird. Verwenden Sie einen SAS-URI mit Lese-, Anfüge-, Erstellungs-, Schreibzugriff ODER verwalteter Identität, um den VM-Zugriff auf das Blob bereitzustellen. Verweisen Sie auf den Parameter "errorBlobManagedIdentity".	Schnur
outputBlobManagedIdentity	Vom Benutzer zugewiesene verwaltete Identität, die Zugriff auf outputBlobUri-Speicherblob hat. Verwenden Sie ein leeres Objekt im Fall der vom System zugewiesenen Identität. Stellen Sie sicher, dass der Container eines Blobs mit der Rollenzuweisung "Storage Blob Data Contributor" auf verwaltete Identität zugreifen konnte. Stellen Sie bei der vom Benutzer zugewiesenen Identität sicher, dass Sie sie unter der Identität des virtuellen Computers hinzufügen. Weitere Informationen zu verwalteter Identität und Befehl ausführen finden Sie unter `https://aka.ms/ManagedIdentity` und `https://aka.ms/RunCommandManaged`	RunCommandManagedIdentity-
outputBlobUri	Gibt das Azure Storage-Blob an, in das der Skriptausgabedatenstrom hochgeladen wird. Verwenden Sie einen SAS-URI mit Lese-, Anfüge-, Erstellungs-, Schreibzugriff ODER verwalteter Identität, um den VM-Zugriff auf das Blob bereitzustellen. Verweisen Sie auf outputBlobManagedIdentity-Parameter.	Schnur
Parameter	Die vom Skript verwendeten Parameter.	RunCommandInputParameter[]
protectedParameters	Die vom Skript verwendeten Parameter.	RunCommandInputParameter[]
runAsPassword	Gibt das Kennwort für das Benutzerkonto auf dem virtuellen Computer an, wenn der Ausführungsbefehl ausgeführt wird.	Schnur
runAsUser	Gibt das Benutzerkonto auf dem virtuellen Computer an, wenn der Ausführungsbefehl ausgeführt wird.	Schnur
Quelle	Die Quelle des Ausführen-Befehlsskripts.	VirtualMachineRunCommandScriptSource-
timeoutInSeconds	Das Timeout in Sekunden, um den Ausführungsbefehl auszuführen.	Int
treatFailureAsDeploymentFailure	Wahlfrei. Wenn dieser Wert auf "true" festgelegt ist, schlägt ein Fehler im Skript fehl, und "ProvisioningState" wird als fehlgeschlagen markiert. Wenn dieser Wert auf "false" festgelegt ist, gibt ProvisioningState nur an, ob der Ausführungsbefehl von der Erweiterungsplattform ausgeführt wurde oder nicht, es würde nicht angegeben, ob das Skript bei Skriptfehlern fehlgeschlagen ist. Anzeigen der Instanzansicht des Ausführungsbefehls im Falle von Skriptfehlern zum Anzeigen von executionMessage, Ausgabe, Fehler: `https://aka.ms/runcommandmanaged#get-execution-status-and-results`	Bool

RunCommandManagedIdentity

Name	Beschreibung	Wert
clientId	Client-ID (GUID-Wert) der vom Benutzer zugewiesenen verwalteten Identität. ObjectId sollte nicht verwendet werden, wenn dies angegeben wird.	Schnur
objectId	Objekt-ID (GUID-Wert) der vom Benutzer zugewiesenen verwalteten Identität. ClientId sollte nicht verwendet werden, wenn dies angegeben wird.	Schnur

RunCommandInputParameter

Name	Beschreibung	Wert
Name	Der Name des Ausführen-Befehlsparameters.	Zeichenfolge (erforderlich)
Wert	Der Wert des Ausführen-Befehlsparameters.	Zeichenfolge (erforderlich)

VirtualMachineRunCommandScriptSource

Name	Beschreibung	Wert
commandId	Gibt eine CommandId des vordefinierten integrierten Skripts an.	Schnur
Skript	Gibt den Skriptinhalt an, der auf dem virtuellen Computer ausgeführt werden soll.	Schnur
scriptUri	Gibt den Speicherort für den Skriptdownload an. Es kann entweder SAS-URI eines Azure Storage-Blobs mit Lesezugriff oder öffentlicher URI sein.	Schnur
scriptUriManagedIdentity	Vom Benutzer zugewiesene verwaltete Identität, die Zugriff auf ScriptUri im Falle eines Azure Storage-BLOB hat. Verwenden Sie ein leeres Objekt im Fall der vom System zugewiesenen Identität. Stellen Sie sicher, dass das Azure Storage-Blob vorhanden ist, und die verwaltete Identität wurde zugriff auf den Container des Blobs mit der Rollenzuweisung "Storage Blob Data Reader" erhalten. Stellen Sie bei der vom Benutzer zugewiesenen Identität sicher, dass Sie sie unter der Identität des virtuellen Computers hinzufügen. Weitere Informationen zu verwalteter Identität und Befehl ausführen finden Sie unter `https://aka.ms/ManagedIdentity` und `https://aka.ms/RunCommandManaged.`	RunCommandManagedIdentity-

Schnellstartvorlagen

Die folgenden Schnellstartvorlagen stellen diesen Ressourcentyp bereit.

Schablone	Beschreibung
SharePoint-Abonnement / 2019 / 2016 vollständig konfiguriert	Erstellen Sie einen DC, einen SQL Server 2022 und von 1 bis 5 Servern, die ein SharePoint-Abonnement /2019/2016-Farm hosten, mit einer umfangreichen Konfiguration, einschließlich vertrauenswürdiger Authentifizierung, Benutzerprofile mit persönlichen Websites, einer OAuth-Vertrauensstellung (mithilfe eines Zertifikats), einer dedizierten IIS-Website zum Hosten besonders vertrauenswürdiger Add-Ins usw. Die neueste Version von Schlüsselsoftware (einschließlich Fiddler, vscode, np++, 7zip, ULS Viewer) wird installiert. SharePoint-Computer verfügen über zusätzliche Feinabstimmungen, um sie sofort nutzbar zu machen (Remoteverwaltungstools, benutzerdefinierte Richtlinien für Edge und Chrome, Tastenkombinationen usw.).
GitLab Omnibus	Diese Vorlage vereinfacht die Bereitstellung von GitLab Omnibus auf einem virtuellen Computer mit einem öffentlichen DNS, wobei das DNS der öffentlichen IP genutzt wird. Es verwendet die Standard_F8s_v2 Instanzgröße, die sich an der Referenzarchitektur richtet und bis zu 1000 Benutzer (20 RPS) unterstützt. Die Instanz ist vorkonfiguriert, um HTTPS mit einem Let's Encrypt-Zertifikat für sichere Verbindungen zu verwenden.

Schablone

Beschreibung

SharePoint-Abonnement / 2019 / 2016 vollständig konfiguriert

Erstellen Sie einen DC, einen SQL Server 2022 und von 1 bis 5 Servern, die ein SharePoint-Abonnement /2019/2016-Farm hosten, mit einer umfangreichen Konfiguration, einschließlich vertrauenswürdiger Authentifizierung, Benutzerprofile mit persönlichen Websites, einer OAuth-Vertrauensstellung (mithilfe eines Zertifikats), einer dedizierten IIS-Website zum Hosten besonders vertrauenswürdiger Add-Ins usw. Die neueste Version von Schlüsselsoftware (einschließlich Fiddler, vscode, np++, 7zip, ULS Viewer) wird installiert. SharePoint-Computer verfügen über zusätzliche Feinabstimmungen, um sie sofort nutzbar zu machen (Remoteverwaltungstools, benutzerdefinierte Richtlinien für Edge und Chrome, Tastenkombinationen usw.).

GitLab Omnibus

Diese Vorlage vereinfacht die Bereitstellung von GitLab Omnibus auf einem virtuellen Computer mit einem öffentlichen DNS, wobei das DNS der öffentlichen IP genutzt wird. Es verwendet die Standard_F8s_v2 Instanzgröße, die sich an der Referenzarchitektur richtet und bis zu 1000 Benutzer (20 RPS) unterstützt. Die Instanz ist vorkonfiguriert, um HTTPS mit einem Let's Encrypt-Zertifikat für sichere Verbindungen zu verwenden.

ARM-Vorlagenressourcendefinition

Der Ressourcentyp "virtualMachines/runCommands" kann mit Vorgängen bereitgestellt werden, die auf Folgendes abzielen:

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": "2024-03-01",
  "name": "string",
  "location": "string",
  "tags": {
    "tagName1": "tagValue1",
    "tagName2": "tagValue2"
  },
  "properties": {
    "asyncExecution": "bool",
    "errorBlobManagedIdentity": {
      "clientId": "string",
      "objectId": "string"
    },
    "errorBlobUri": "string",
    "outputBlobManagedIdentity": {
      "clientId": "string",
      "objectId": "string"
    },
    "outputBlobUri": "string",
    "parameters": [
      {
        "name": "string",
        "value": "string"
      }
    ],
    "protectedParameters": [
      {
        "name": "string",
        "value": "string"
      }
    ],
    "runAsPassword": "string",
    "runAsUser": "string",
    "source": {
      "commandId": "string",
      "script": "string",
      "scriptUri": "string",
      "scriptUriManagedIdentity": {
        "clientId": "string",
        "objectId": "string"
      }
    },
    "timeoutInSeconds": "int",
    "treatFailureAsDeploymentFailure": "bool"
  }
}

Eigenschaftswerte

virtualMachines/runCommands

Name	Beschreibung	Wert
Art	Der Ressourcentyp	"Microsoft.Compute/virtualMachines/runCommands"
apiVersion	Die Ressourcen-API-Version	'2024-03-01'
Name	Der Ressourcenname Erfahren Sie, wie Sie Namen und Typen für untergeordnete Ressourcen in JSON ARM-Vorlagenfestlegen.	Zeichenfolge (erforderlich)
Ort	Ressourcenspeicherort	Zeichenfolge (erforderlich)
Schilder	Ressourcentags	Wörterbuch der Tagnamen und -werte. Siehe Tags in Vorlagen
Eigenschaften	Beschreibt die Eigenschaften eines Befehls zum Ausführen eines virtuellen Computers.	VirtualMachineRunCommandProperties

VirtualMachineRunCommandProperties

Name	Beschreibung	Wert
asyncExecution	Wahlfrei. Wenn "true" festgelegt ist, wird die Bereitstellung abgeschlossen, sobald das Skript gestartet wird und nicht auf den Abschluss des Skripts wartet.	Bool
errorBlobManagedIdentity	Vom Benutzer zugewiesene verwaltete Identität, die Zugriff auf den FehlerBlobUri-Speicherblob hat. Verwenden Sie ein leeres Objekt im Fall der vom System zugewiesenen Identität. Stellen Sie sicher, dass der Container eines Blobs mit der Rollenzuweisung "Storage Blob Data Contributor" auf verwaltete Identität zugreifen konnte. Stellen Sie bei der vom Benutzer zugewiesenen Identität sicher, dass Sie sie unter der Identität des virtuellen Computers hinzufügen. Weitere Informationen zu verwalteter Identität und Befehl ausführen finden Sie unter `https://aka.ms/ManagedIdentity` und `https://aka.ms/RunCommandManaged`	RunCommandManagedIdentity-
errorBlobUri	Gibt das Azure Storage-Blob an, bei dem der Skriptfehlerdatenstrom hochgeladen wird. Verwenden Sie einen SAS-URI mit Lese-, Anfüge-, Erstellungs-, Schreibzugriff ODER verwalteter Identität, um den VM-Zugriff auf das Blob bereitzustellen. Verweisen Sie auf den Parameter "errorBlobManagedIdentity".	Schnur
outputBlobManagedIdentity	Vom Benutzer zugewiesene verwaltete Identität, die Zugriff auf outputBlobUri-Speicherblob hat. Verwenden Sie ein leeres Objekt im Fall der vom System zugewiesenen Identität. Stellen Sie sicher, dass der Container eines Blobs mit der Rollenzuweisung "Storage Blob Data Contributor" auf verwaltete Identität zugreifen konnte. Stellen Sie bei der vom Benutzer zugewiesenen Identität sicher, dass Sie sie unter der Identität des virtuellen Computers hinzufügen. Weitere Informationen zu verwalteter Identität und Befehl ausführen finden Sie unter `https://aka.ms/ManagedIdentity` und `https://aka.ms/RunCommandManaged`	RunCommandManagedIdentity-
outputBlobUri	Gibt das Azure Storage-Blob an, in das der Skriptausgabedatenstrom hochgeladen wird. Verwenden Sie einen SAS-URI mit Lese-, Anfüge-, Erstellungs-, Schreibzugriff ODER verwalteter Identität, um den VM-Zugriff auf das Blob bereitzustellen. Verweisen Sie auf outputBlobManagedIdentity-Parameter.	Schnur
Parameter	Die vom Skript verwendeten Parameter.	RunCommandInputParameter[]
protectedParameters	Die vom Skript verwendeten Parameter.	RunCommandInputParameter[]
runAsPassword	Gibt das Kennwort für das Benutzerkonto auf dem virtuellen Computer an, wenn der Ausführungsbefehl ausgeführt wird.	Schnur
runAsUser	Gibt das Benutzerkonto auf dem virtuellen Computer an, wenn der Ausführungsbefehl ausgeführt wird.	Schnur
Quelle	Die Quelle des Ausführen-Befehlsskripts.	VirtualMachineRunCommandScriptSource-
timeoutInSeconds	Das Timeout in Sekunden, um den Ausführungsbefehl auszuführen.	Int
treatFailureAsDeploymentFailure	Wahlfrei. Wenn dieser Wert auf "true" festgelegt ist, schlägt ein Fehler im Skript fehl, und "ProvisioningState" wird als fehlgeschlagen markiert. Wenn dieser Wert auf "false" festgelegt ist, gibt ProvisioningState nur an, ob der Ausführungsbefehl von der Erweiterungsplattform ausgeführt wurde oder nicht, es würde nicht angegeben, ob das Skript bei Skriptfehlern fehlgeschlagen ist. Anzeigen der Instanzansicht des Ausführungsbefehls im Falle von Skriptfehlern zum Anzeigen von executionMessage, Ausgabe, Fehler: `https://aka.ms/runcommandmanaged#get-execution-status-and-results`	Bool

RunCommandManagedIdentity

Name	Beschreibung	Wert
clientId	Client-ID (GUID-Wert) der vom Benutzer zugewiesenen verwalteten Identität. ObjectId sollte nicht verwendet werden, wenn dies angegeben wird.	Schnur
objectId	Objekt-ID (GUID-Wert) der vom Benutzer zugewiesenen verwalteten Identität. ClientId sollte nicht verwendet werden, wenn dies angegeben wird.	Schnur

RunCommandInputParameter

Name	Beschreibung	Wert
Name	Der Name des Ausführen-Befehlsparameters.	Zeichenfolge (erforderlich)
Wert	Der Wert des Ausführen-Befehlsparameters.	Zeichenfolge (erforderlich)

VirtualMachineRunCommandScriptSource

Name	Beschreibung	Wert
commandId	Gibt eine CommandId des vordefinierten integrierten Skripts an.	Schnur
Skript	Gibt den Skriptinhalt an, der auf dem virtuellen Computer ausgeführt werden soll.	Schnur
scriptUri	Gibt den Speicherort für den Skriptdownload an. Es kann entweder SAS-URI eines Azure Storage-Blobs mit Lesezugriff oder öffentlicher URI sein.	Schnur
scriptUriManagedIdentity	Vom Benutzer zugewiesene verwaltete Identität, die Zugriff auf ScriptUri im Falle eines Azure Storage-BLOB hat. Verwenden Sie ein leeres Objekt im Fall der vom System zugewiesenen Identität. Stellen Sie sicher, dass das Azure Storage-Blob vorhanden ist, und die verwaltete Identität wurde zugriff auf den Container des Blobs mit der Rollenzuweisung "Storage Blob Data Reader" erhalten. Stellen Sie bei der vom Benutzer zugewiesenen Identität sicher, dass Sie sie unter der Identität des virtuellen Computers hinzufügen. Weitere Informationen zu verwalteter Identität und Befehl ausführen finden Sie unter `https://aka.ms/ManagedIdentity` und `https://aka.ms/RunCommandManaged.`	RunCommandManagedIdentity-

Schnellstartvorlagen

Die folgenden Schnellstartvorlagen stellen diesen Ressourcentyp bereit.

Schablone	Beschreibung
SharePoint-Abonnement / 2019 / 2016 vollständig konfiguriert	Erstellen Sie einen DC, einen SQL Server 2022 und von 1 bis 5 Servern, die ein SharePoint-Abonnement /2019/2016-Farm hosten, mit einer umfangreichen Konfiguration, einschließlich vertrauenswürdiger Authentifizierung, Benutzerprofile mit persönlichen Websites, einer OAuth-Vertrauensstellung (mithilfe eines Zertifikats), einer dedizierten IIS-Website zum Hosten besonders vertrauenswürdiger Add-Ins usw. Die neueste Version von Schlüsselsoftware (einschließlich Fiddler, vscode, np++, 7zip, ULS Viewer) wird installiert. SharePoint-Computer verfügen über zusätzliche Feinabstimmungen, um sie sofort nutzbar zu machen (Remoteverwaltungstools, benutzerdefinierte Richtlinien für Edge und Chrome, Tastenkombinationen usw.).
GitLab Omnibus	Diese Vorlage vereinfacht die Bereitstellung von GitLab Omnibus auf einem virtuellen Computer mit einem öffentlichen DNS, wobei das DNS der öffentlichen IP genutzt wird. Es verwendet die Standard_F8s_v2 Instanzgröße, die sich an der Referenzarchitektur richtet und bis zu 1000 Benutzer (20 RPS) unterstützt. Die Instanz ist vorkonfiguriert, um HTTPS mit einem Let's Encrypt-Zertifikat für sichere Verbindungen zu verwenden.

Schablone

Beschreibung

SharePoint-Abonnement / 2019 / 2016 vollständig konfiguriert

Erstellen Sie einen DC, einen SQL Server 2022 und von 1 bis 5 Servern, die ein SharePoint-Abonnement /2019/2016-Farm hosten, mit einer umfangreichen Konfiguration, einschließlich vertrauenswürdiger Authentifizierung, Benutzerprofile mit persönlichen Websites, einer OAuth-Vertrauensstellung (mithilfe eines Zertifikats), einer dedizierten IIS-Website zum Hosten besonders vertrauenswürdiger Add-Ins usw. Die neueste Version von Schlüsselsoftware (einschließlich Fiddler, vscode, np++, 7zip, ULS Viewer) wird installiert. SharePoint-Computer verfügen über zusätzliche Feinabstimmungen, um sie sofort nutzbar zu machen (Remoteverwaltungstools, benutzerdefinierte Richtlinien für Edge und Chrome, Tastenkombinationen usw.).

GitLab Omnibus

Diese Vorlage vereinfacht die Bereitstellung von GitLab Omnibus auf einem virtuellen Computer mit einem öffentlichen DNS, wobei das DNS der öffentlichen IP genutzt wird. Es verwendet die Standard_F8s_v2 Instanzgröße, die sich an der Referenzarchitektur richtet und bis zu 1000 Benutzer (20 RPS) unterstützt. Die Instanz ist vorkonfiguriert, um HTTPS mit einem Let's Encrypt-Zertifikat für sichere Verbindungen zu verwenden.

Terraform -Ressourcendefinition (AzAPI-Anbieter)

Der Ressourcentyp "virtualMachines/runCommands" kann mit Vorgängen bereitgestellt werden, die auf Folgendes abzielen:

Ressourcengruppe

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 Ihrer Vorlage die folgende Terraform hinzu.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Compute/virtualMachines/runCommands@2024-03-01"
  name = "string"
  location = "string"
  parent_id = "string"
  tags = {
    tagName1 = "tagValue1"
    tagName2 = "tagValue2"
  }
  body = jsonencode({
    properties = {
      asyncExecution = bool
      errorBlobManagedIdentity = {
        clientId = "string"
        objectId = "string"
      }
      errorBlobUri = "string"
      outputBlobManagedIdentity = {
        clientId = "string"
        objectId = "string"
      }
      outputBlobUri = "string"
      parameters = [
        {
          name = "string"
          value = "string"
        }
      ]
      protectedParameters = [
        {
          name = "string"
          value = "string"
        }
      ]
      runAsPassword = "string"
      runAsUser = "string"
      source = {
        commandId = "string"
        script = "string"
        scriptUri = "string"
        scriptUriManagedIdentity = {
          clientId = "string"
          objectId = "string"
        }
      }
      timeoutInSeconds = int
      treatFailureAsDeploymentFailure = bool
    }
  })
}

Eigenschaftswerte

virtualMachines/runCommands

Name	Beschreibung	Wert
Art	Der Ressourcentyp	"Microsoft.Compute/virtualMachines/runCommands@2024-03-01"
Name	Der Ressourcenname	Zeichenfolge (erforderlich)
Ort	Ressourcenspeicherort	Zeichenfolge (erforderlich)
parent_id	Die ID der Ressource, die das übergeordnete Element für diese Ressource ist.	ID für Ressource vom Typ: virtualMachines
Schilder	Ressourcentags	Wörterbuch der Tagnamen und -werte.
Eigenschaften	Beschreibt die Eigenschaften eines Befehls zum Ausführen eines virtuellen Computers.	VirtualMachineRunCommandProperties

VirtualMachineRunCommandProperties

Name	Beschreibung	Wert
asyncExecution	Wahlfrei. Wenn "true" festgelegt ist, wird die Bereitstellung abgeschlossen, sobald das Skript gestartet wird und nicht auf den Abschluss des Skripts wartet.	Bool
errorBlobManagedIdentity	Vom Benutzer zugewiesene verwaltete Identität, die Zugriff auf den FehlerBlobUri-Speicherblob hat. Verwenden Sie ein leeres Objekt im Fall der vom System zugewiesenen Identität. Stellen Sie sicher, dass der Container eines Blobs mit der Rollenzuweisung "Storage Blob Data Contributor" auf verwaltete Identität zugreifen konnte. Stellen Sie bei der vom Benutzer zugewiesenen Identität sicher, dass Sie sie unter der Identität des virtuellen Computers hinzufügen. Weitere Informationen zu verwalteter Identität und Befehl ausführen finden Sie unter `https://aka.ms/ManagedIdentity` und `https://aka.ms/RunCommandManaged`	RunCommandManagedIdentity-
errorBlobUri	Gibt das Azure Storage-Blob an, bei dem der Skriptfehlerdatenstrom hochgeladen wird. Verwenden Sie einen SAS-URI mit Lese-, Anfüge-, Erstellungs-, Schreibzugriff ODER verwalteter Identität, um den VM-Zugriff auf das Blob bereitzustellen. Verweisen Sie auf den Parameter "errorBlobManagedIdentity".	Schnur
outputBlobManagedIdentity	Vom Benutzer zugewiesene verwaltete Identität, die Zugriff auf outputBlobUri-Speicherblob hat. Verwenden Sie ein leeres Objekt im Fall der vom System zugewiesenen Identität. Stellen Sie sicher, dass der Container eines Blobs mit der Rollenzuweisung "Storage Blob Data Contributor" auf verwaltete Identität zugreifen konnte. Stellen Sie bei der vom Benutzer zugewiesenen Identität sicher, dass Sie sie unter der Identität des virtuellen Computers hinzufügen. Weitere Informationen zu verwalteter Identität und Befehl ausführen finden Sie unter `https://aka.ms/ManagedIdentity` und `https://aka.ms/RunCommandManaged`	RunCommandManagedIdentity-
outputBlobUri	Gibt das Azure Storage-Blob an, in das der Skriptausgabedatenstrom hochgeladen wird. Verwenden Sie einen SAS-URI mit Lese-, Anfüge-, Erstellungs-, Schreibzugriff ODER verwalteter Identität, um den VM-Zugriff auf das Blob bereitzustellen. Verweisen Sie auf outputBlobManagedIdentity-Parameter.	Schnur
Parameter	Die vom Skript verwendeten Parameter.	RunCommandInputParameter[]
protectedParameters	Die vom Skript verwendeten Parameter.	RunCommandInputParameter[]
runAsPassword	Gibt das Kennwort für das Benutzerkonto auf dem virtuellen Computer an, wenn der Ausführungsbefehl ausgeführt wird.	Schnur
runAsUser	Gibt das Benutzerkonto auf dem virtuellen Computer an, wenn der Ausführungsbefehl ausgeführt wird.	Schnur
Quelle	Die Quelle des Ausführen-Befehlsskripts.	VirtualMachineRunCommandScriptSource-
timeoutInSeconds	Das Timeout in Sekunden, um den Ausführungsbefehl auszuführen.	Int
treatFailureAsDeploymentFailure	Wahlfrei. Wenn dieser Wert auf "true" festgelegt ist, schlägt ein Fehler im Skript fehl, und "ProvisioningState" wird als fehlgeschlagen markiert. Wenn dieser Wert auf "false" festgelegt ist, gibt ProvisioningState nur an, ob der Ausführungsbefehl von der Erweiterungsplattform ausgeführt wurde oder nicht, es würde nicht angegeben, ob das Skript bei Skriptfehlern fehlgeschlagen ist. Anzeigen der Instanzansicht des Ausführungsbefehls im Falle von Skriptfehlern zum Anzeigen von executionMessage, Ausgabe, Fehler: `https://aka.ms/runcommandmanaged#get-execution-status-and-results`	Bool

RunCommandManagedIdentity

Name	Beschreibung	Wert
clientId	Client-ID (GUID-Wert) der vom Benutzer zugewiesenen verwalteten Identität. ObjectId sollte nicht verwendet werden, wenn dies angegeben wird.	Schnur
objectId	Objekt-ID (GUID-Wert) der vom Benutzer zugewiesenen verwalteten Identität. ClientId sollte nicht verwendet werden, wenn dies angegeben wird.	Schnur

RunCommandInputParameter

Name	Beschreibung	Wert
Name	Der Name des Ausführen-Befehlsparameters.	Zeichenfolge (erforderlich)
Wert	Der Wert des Ausführen-Befehlsparameters.	Zeichenfolge (erforderlich)

VirtualMachineRunCommandScriptSource

Name	Beschreibung	Wert
commandId	Gibt eine CommandId des vordefinierten integrierten Skripts an.	Schnur
Skript	Gibt den Skriptinhalt an, der auf dem virtuellen Computer ausgeführt werden soll.	Schnur
scriptUri	Gibt den Speicherort für den Skriptdownload an. Es kann entweder SAS-URI eines Azure Storage-Blobs mit Lesezugriff oder öffentlicher URI sein.	Schnur
scriptUriManagedIdentity	Vom Benutzer zugewiesene verwaltete Identität, die Zugriff auf ScriptUri im Falle eines Azure Storage-BLOB hat. Verwenden Sie ein leeres Objekt im Fall der vom System zugewiesenen Identität. Stellen Sie sicher, dass das Azure Storage-Blob vorhanden ist, und die verwaltete Identität wurde zugriff auf den Container des Blobs mit der Rollenzuweisung "Storage Blob Data Reader" erhalten. Stellen Sie bei der vom Benutzer zugewiesenen Identität sicher, dass Sie sie unter der Identität des virtuellen Computers hinzufügen. Weitere Informationen zu verwalteter Identität und Befehl ausführen finden Sie unter `https://aka.ms/ManagedIdentity` und `https://aka.ms/RunCommandManaged.`	RunCommandManagedIdentity-

Freigeben über

Microsoft.Compute virtualMachines/runCommands 2024-03-01

Bicep-Ressourcendefinition

Ressourcenformat

Eigenschaftswerte

virtualMachines/runCommands

VirtualMachineRunCommandProperties

RunCommandManagedIdentity

RunCommandInputParameter

VirtualMachineRunCommandScriptSource

Schnellstartvorlagen

ARM-Vorlagenressourcendefinition

Ressourcenformat

Eigenschaftswerte

virtualMachines/runCommands

VirtualMachineRunCommandProperties

RunCommandManagedIdentity

RunCommandInputParameter

VirtualMachineRunCommandScriptSource

Schnellstartvorlagen

Terraform -Ressourcendefinition (AzAPI-Anbieter)

Ressourcenformat

Eigenschaftswerte

virtualMachines/runCommands

VirtualMachineRunCommandProperties

RunCommandManagedIdentity

RunCommandInputParameter

VirtualMachineRunCommandScriptSource

Feedback

Zusätzliche Ressourcen