Freigeben über

Microsoft.Compute virtualMachines/runCommands 2022-03-01

  • Artikel

Bicep-Ressourcendefinition

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

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@2022-03-01' = {
  parent: resourceSymbolicName
  location: 'string'
  name: 'string'
  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
  }
  tags: {
    {customized property}: 'string'
  }
}

Eigenschaftswerte

Microsoft.Compute/virtualMachines/runCommands

Name Beschreibung Wert
Ort Ressourcenspeicherort Zeichenfolge (erforderlich)
Name Der Ressourcenname Zeichenfolge (erforderlich)
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
Schilder Ressourcentags Wörterbuch der Tagnamen und -werte. Siehe Tags in Vorlagen

ResourceTags

Name Beschreibung Wert

RunCommandInputParameter

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

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
errorBlobUri Gibt das Azure Storage-Blob an, bei dem der Skriptfehlerdatenstrom hochgeladen wird. Schnur
outputBlobUri Gibt das Azure Storage-Blob an, in das der Skriptausgabedatenstrom hochgeladen wird. 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

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. Schnur

Schnellstartbeispiele

Die folgenden Schnellstartbeispiele stellen diesen Ressourcentyp bereit.

Bicep-Datei Beschreibung
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.
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.).

ARM-Vorlagenressourcendefinition

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

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-03-01",
  "name": "string",
  "location": "string",
  "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"
  },
  "tags": {
    "{customized property}": "string"
  }
}

Eigenschaftswerte

Microsoft.Compute/virtualMachines/runCommands

Name Beschreibung Wert
apiVersion Die API-Version '2022-03-01'
Ort Ressourcenspeicherort Zeichenfolge (erforderlich)
Name Der Ressourcenname Zeichenfolge (erforderlich)
Eigenschaften Beschreibt die Eigenschaften eines Befehls zum Ausführen eines virtuellen Computers. VirtualMachineRunCommandProperties
Schilder Ressourcentags Wörterbuch der Tagnamen und -werte. Siehe Tags in Vorlagen
Art Der Ressourcentyp "Microsoft.Compute/virtualMachines/runCommands"

ResourceTags

Name Beschreibung Wert

RunCommandInputParameter

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

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
errorBlobUri Gibt das Azure Storage-Blob an, bei dem der Skriptfehlerdatenstrom hochgeladen wird. Schnur
outputBlobUri Gibt das Azure Storage-Blob an, in das der Skriptausgabedatenstrom hochgeladen wird. 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

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. Schnur

Schnellstartvorlagen

Die folgenden Schnellstartvorlagen stellen diesen Ressourcentyp bereit.

Schablone Beschreibung
GitLab Omnibus

Bereitstellen in Azure 		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.
SharePoint-Abonnement / 2019 / 2016 vollständig konfiguriert

Bereitstellen in Azure 		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.).

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@2022-03-01"
  name = "string"
  location = "string"
  tags = {
    {customized property} = "string"
  }
  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

Microsoft.Compute/virtualMachines/runCommands

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

ResourceTags

Name Beschreibung Wert

RunCommandInputParameter

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

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
errorBlobUri Gibt das Azure Storage-Blob an, bei dem der Skriptfehlerdatenstrom hochgeladen wird. Schnur
outputBlobUri Gibt das Azure Storage-Blob an, in das der Skriptausgabedatenstrom hochgeladen wird. 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

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. Schnur