Microsoft.Compute virtualMachines/runCommands 2020-12-01

  • Artículo

Definición de recursos de Bicep

El tipo de recurso virtualMachines/runCommands se puede implementar con operaciones destinadas a:

Para obtener una lista de las propiedades modificadas en cada versión de API, consulte registro de cambios.

Formato de los recursos

Para crear un recurso Microsoft.Compute/virtualMachines/runCommands, agregue el siguiente bicep a la plantilla.

resource symbolicname 'Microsoft.Compute/virtualMachines/runCommands@2020-12-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
  }
}

Valores de propiedad

virtualMachines/runCommands

Nombre Descripción Value
name El nombre del recurso

Vea cómo establecer nombres y tipos para recursos secundarios en Bicep.		 string (obligatorio)
ubicación Ubicación de los recursos string (obligatorio)
etiquetas Etiquetas del recurso Diccionario de nombres y valores de etiqueta. Consulte Etiquetas en plantillas.
primario En Bicep, puede especificar el recurso primario para un recurso secundario. Solo tiene que agregar esta propiedad cuando el recurso secundario se declara fuera del recurso primario.

Para más información, consulte Recurso secundario fuera del recurso primario.		 Nombre simbólico del recurso de tipo: virtualMachines
properties Describe las propiedades de un comando de ejecución de máquina virtual. VirtualMachineRunCommandProperties

VirtualMachineRunCommandProperties

Nombre Descripción Valor
asyncExecution Opcional. Si se establece en true, el aprovisionamiento se completará en cuanto se inicie el script y no esperará a que se complete el script. bool
errorBlobUri Especifica el blob de Azure Storage donde se cargará el flujo de error del script. string
outputBlobUri Especifica el blob de Azure Storage donde se cargará el flujo de salida del script. string
parámetros Parámetros usados por el script. RunCommandInputParameter[]
protectedParameters Parámetros usados por el script. RunCommandInputParameter[]
runAsPassword Especifica la contraseña de la cuenta de usuario en la máquina virtual al ejecutar el comando run. string
runAsUser Especifica la cuenta de usuario en la máquina virtual al ejecutar el comando run. string
source Origen del script de comando de ejecución. VirtualMachineRunCommandScriptSource
timeoutInSeconds Tiempo de espera en segundos para ejecutar el comando run. int

RunCommandInputParameter

Nombre Descripción Value
name Nombre del parámetro de comando run. string (obligatorio)
value Valor del parámetro del comando run. string (obligatorio)

VirtualMachineRunCommandScriptSource

Nombre Descripción Valor
commandId Especifica un commandId de script integrado predefinido. string
script Especifica el contenido del script que se va a ejecutar en la máquina virtual. string
scriptUri Especifica la ubicación de descarga del script. string

Plantillas de inicio rápido

Las siguientes plantillas de inicio rápido implementan este tipo de recurso.

Plantilla Descripción
Suscripción de SharePoint / 2019 / 2016 / 2013 todo configurado

Implementación en Azure		 Esta plantilla crea una granja de sharePoint Subscription/2019/2016/2013 con una amplia configuración que tardaría en realizar manualmente, incluida una autenticación federada con ADFS, una confianza de OAuth, el servicio Perfiles de usuario y una aplicación web con 2 zonas que contienen varias colecciones de sitios basadas en rutas de acceso y con nombre de host. En las máquinas virtuales de SharePoint, Chocolatey se usa para instalar la versión más reciente del Bloc de notas++, Visual Studio Code, Azure Data Studio, Fiddler, ULS Viewer y 7-Zip.

Definición de recursos de plantilla de ARM

El tipo de recurso virtualMachines/runCommands se puede implementar con operaciones destinadas a:

Para obtener una lista de las propiedades modificadas en cada versión de API, consulte registro de cambios.

Formato de los recursos

Para crear un recurso Microsoft.Compute/virtualMachines/runCommands, agregue el siguiente json a la plantilla.

{
  "type": "Microsoft.Compute/virtualMachines/runCommands",
  "apiVersion": "2020-12-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"
  }
}

Valores de propiedad

virtualMachines/runCommands

Nombre Descripción Value
type Tipo de recurso 'Microsoft.Compute/virtualMachines/runCommands'
apiVersion La versión de la API de recursos '2020-12-01'
name El nombre del recurso

Vea cómo establecer nombres y tipos para recursos secundarios en plantillas de ARM JSON.		 string (obligatorio)
ubicación Ubicación de los recursos string (obligatorio)
etiquetas Etiquetas del recurso Diccionario de nombres y valores de etiqueta. Consulte Etiquetas en plantillas.
properties Describe las propiedades de un comando de ejecución de máquina virtual. VirtualMachineRunCommandProperties

VirtualMachineRunCommandProperties

Nombre Descripción Valor
asyncExecution Opcional. Si se establece en true, el aprovisionamiento se completará en cuanto se inicie el script y no esperará a que se complete el script. bool
errorBlobUri Especifica el blob de Azure Storage donde se cargará el flujo de error del script. string
outputBlobUri Especifica el blob de Azure Storage donde se cargará el flujo de salida del script. string
parámetros Parámetros usados por el script. RunCommandInputParameter[]
protectedParameters Parámetros usados por el script. RunCommandInputParameter[]
runAsPassword Especifica la contraseña de la cuenta de usuario en la máquina virtual al ejecutar el comando run. string
runAsUser Especifica la cuenta de usuario en la máquina virtual al ejecutar el comando run. string
source Origen del script de comando de ejecución. VirtualMachineRunCommandScriptSource
timeoutInSeconds Tiempo de espera en segundos para ejecutar el comando run. int

RunCommandInputParameter

Nombre Descripción Value
name Nombre del parámetro de comando run. string (obligatorio)
value Valor del parámetro del comando run. string (obligatorio)

VirtualMachineRunCommandScriptSource

Nombre Descripción Valor
commandId Especifica un commandId de script integrado predefinido. string
script Especifica el contenido del script que se va a ejecutar en la máquina virtual. string
scriptUri Especifica la ubicación de descarga del script. string

Plantillas de inicio rápido

Las siguientes plantillas de inicio rápido implementan este tipo de recurso.

Plantilla Descripción
Suscripción de SharePoint / 2019 / 2016 / 2013 todo configurado

Implementación en Azure		 Esta plantilla crea una granja de sharePoint Subscription/2019/2016/2013 con una amplia configuración que tardaría en realizar manualmente, incluida una autenticación federada con ADFS, una confianza de OAuth, el servicio Perfiles de usuario y una aplicación web con 2 zonas que contienen varias colecciones de sitios basadas en rutas de acceso y con nombre de host. En las máquinas virtuales de SharePoint, Chocolatey se usa para instalar la versión más reciente del Bloc de notas++, Visual Studio Code, Azure Data Studio, Fiddler, ULS Viewer y 7-Zip.

Definición de recursos de Terraform (proveedor AzAPI)

El tipo de recurso virtualMachines/runCommands se puede implementar con operaciones destinadas a:

  • Grupos de recursos

Para obtener una lista de las propiedades modificadas en cada versión de API, consulte registro de cambios.

Formato de los recursos

Para crear un recurso Microsoft.Compute/virtualMachines/runCommands, agregue el siguiente terraform a la plantilla.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Compute/virtualMachines/runCommands@2020-12-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
    }
  })
}

Valores de propiedad

virtualMachines/runCommands

Nombre Descripción Value
type Tipo de recurso "Microsoft.Compute/virtualMachines/runCommands@2020-12-01"
name El nombre del recurso string (obligatorio)
ubicación Ubicación de los recursos string (obligatorio)
parent_id Identificador del recurso que es el elemento primario de este recurso. Identificador del recurso de tipo: virtualMachines
etiquetas Etiquetas del recurso Diccionario de nombres y valores de etiqueta.
properties Describe las propiedades de un comando de ejecución de máquina virtual. VirtualMachineRunCommandProperties

VirtualMachineRunCommandProperties

Nombre Descripción Valor
asyncExecution Opcional. Si se establece en true, el aprovisionamiento se completará en cuanto se inicie el script y no esperará a que se complete el script. bool
errorBlobUri Especifica el blob de Azure Storage donde se cargará el flujo de error del script. string
outputBlobUri Especifica el blob de Azure Storage donde se cargará el flujo de salida del script. string
parámetros Parámetros usados por el script. RunCommandInputParameter[]
protectedParameters Parámetros usados por el script. RunCommandInputParameter[]
runAsPassword Especifica la contraseña de la cuenta de usuario en la máquina virtual al ejecutar el comando run. string
runAsUser Especifica la cuenta de usuario en la máquina virtual al ejecutar el comando run. string
source Origen del script de comando de ejecución. VirtualMachineRunCommandScriptSource
timeoutInSeconds Tiempo de espera en segundos para ejecutar el comando run. int

RunCommandInputParameter

Nombre Descripción Value
name Nombre del parámetro de comando run. string (obligatorio)
value Valor del parámetro del comando run. string (obligatorio)

VirtualMachineRunCommandScriptSource

Nombre Descripción Valor
commandId Especifica un commandId de script integrado predefinido. string
script Especifica el contenido del script que se va a ejecutar en la máquina virtual. string
scriptUri Especifica la ubicación de descarga del script. string