Partilhar via

Microsoft.Compute virtualMachines/runCommands 2021-03-01

  • Artigo

Definição de recurso do Bicep

O tipo de recurso virtualMachines/runCommands pode ser implementado com operações que visam:

Para obter uma lista de propriedades alteradas em cada versão da API, veja registo de alterações.

Formato do recurso

Para criar um recurso Microsoft.Compute/virtualMachines/runCommands, adicione o seguinte Bicep ao seu modelo.

resource symbolicname 'Microsoft.Compute/virtualMachines/runCommands@2021-03-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 propriedade

virtualMachines/runCommands

Nome Descrição Valor
name O nome do recurso

Veja como definir nomes e tipos para recursos subordinados no Bicep.		 cadeia (obrigatório)
localização Localização do recurso cadeia (obrigatório)
etiquetas Etiquetas de recursos Dicionário de nomes e valores de etiquetas. Ver Etiquetas em modelos
principal No Bicep, pode especificar o recurso principal de um recurso subordinado. Só precisa de adicionar esta propriedade quando o recurso subordinado for declarado fora do recurso principal.

Para obter mais informações, veja Recurso subordinado fora do recurso principal.		 Nome simbólico para recurso do tipo: virtualMachines
propriedades Descreve as propriedades de um comando de execução de Máquina Virtual. VirtualMachineRunCommandProperties

VirtualMachineRunCommandProperties

Nome Descrição Valor
asyncExecution Opcional. Se estiver definido como verdadeiro, o aprovisionamento será concluído assim que o script for iniciado e não aguardará pela conclusão do script. bool
errorBlobUri Especifica o blob de armazenamento do Azure onde o fluxo de erros do script será carregado. string
outputBlobUri Especifica o blob de armazenamento do Azure onde o fluxo de saída do script será carregado. string
parâmetros Os parâmetros utilizados pelo script. RunCommandInputParameter[]
protectedParameters Os parâmetros utilizados pelo script. RunCommandInputParameter[]
runAsPassword Especifica a palavra-passe da conta de utilizador na VM ao executar o comando executar. string
runAsUser Especifica a conta de utilizador na VM ao executar o comando executar. string
source A origem do script de comandos de execução. VirtualMachineRunCommandScriptSource
timeoutInSeconds O tempo limite em segundos para executar o comando executar. int

ExecutarCommandInputParameter

Nome Descrição Valor
name O nome do parâmetro de comando de execução. cadeia (obrigatório)
valor O valor do parâmetro de comando de execução. cadeia (obrigatório)

VirtualMachineRunCommandScriptSource

Nome Descrição Valor
commandId Especifica um commandId de script incorporado predefinido. string
script Especifica o conteúdo do script a ser executado na VM. string
scriptUri Especifica a localização de transferência do script. string

Modelos de início rápido

Os seguintes modelos de início rápido implementam este tipo de recurso.

Modelo Description
Subscrição do SharePoint/2019/2016/2013 todas configuradas

Implementar no Azure		 Este modelo cria uma Subscrição do SharePoint/2019/2016/2013 com uma configuração extensa que demoraria muito tempo a ser executada manualmente, incluindo uma autenticação federada com o ADFS, uma confiança OAuth, o serviço Perfis de Utilizador e uma aplicação Web com 2 zonas que contém múltiplas coleções de sites baseadas em caminhos e com nome de anfitrião. Nas máquinas virtuais do SharePoint, o Chocolatey é utilizado para instalar a versão mais recente do Notepad++, Visual Studio Code, Azure Data Studio, Fiddler, ULS Viewer e 7-Zip.

Definição de recurso do modelo arm

O tipo de recurso virtualMachines/runCommands pode ser implementado com operações que visam:

Para obter uma lista das propriedades alteradas em cada versão da API, veja Registo de alterações.

Formato do recurso

Para criar um recurso Microsoft.Compute/virtualMachines/runCommands, adicione o seguinte JSON ao seu modelo.

{
  "type": "Microsoft.Compute/virtualMachines/runCommands",
  "apiVersion": "2021-03-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 propriedade

virtualMachines/runCommands

Nome Descrição Valor
tipo O tipo de recurso "Microsoft.Compute/virtualMachines/runCommands"
apiVersion A versão da API de recursos '2021-03-01'
name O nome do recurso

Veja como definir nomes e tipos para recursos subordinados em modelos arm JSON.		 cadeia (obrigatório)
localização Localização do recurso cadeia (obrigatório)
etiquetas Etiquetas de recursos Dicionário de nomes e valores de etiquetas. Ver Etiquetas em modelos
propriedades Descreve as propriedades de um comando de execução de Máquina Virtual. VirtualMachineRunCommandProperties

VirtualMachineRunCommandProperties

Nome Descrição Valor
asyncExecution Opcional. Se estiver definido como verdadeiro, o aprovisionamento será concluído assim que o script for iniciado e não aguardará que o script seja concluído. bool
errorBlobUri Especifica o blob de armazenamento do Azure onde o fluxo de erros do script será carregado. string
outputBlobUri Especifica o blob de armazenamento do Azure onde o fluxo de saída do script será carregado. string
parâmetros Os parâmetros utilizados pelo script. RunCommandInputParameter[]
protectedParameters Os parâmetros utilizados pelo script. RunCommandInputParameter[]
runAsPassword Especifica a palavra-passe da conta de utilizador na VM ao executar o comando executar. string
runAsUser Especifica a conta de utilizador na VM ao executar o comando executar. string
source A origem do script de comandos de execução. VirtualMachineRunCommandScriptSource
timeoutInSeconds O tempo limite em segundos para executar o comando de execução. int

RunCommandInputParameter

Nome Descrição Valor
name O nome do parâmetro de comando de execução. cadeia (obrigatório)
valor O valor do parâmetro de comando executar. cadeia (obrigatório)

VirtualMachineRunCommandScriptSource

Nome Descrição Valor
commandId Especifica um commandId de script incorporado predefinido. string
script Especifica o conteúdo do script a ser executado na VM. string
scriptUri Especifica a localização de transferência do script. string

Modelos de início rápido

Os seguintes modelos de início rápido implementam este tipo de recurso.

Modelo Description
Subscrição do SharePoint/2019/2016/2013 todas configuradas

Implementar no Azure		 Este modelo cria uma Subscrição do SharePoint/2019/2016/2013 com uma configuração extensa que demoraria muito tempo a ser executada manualmente, incluindo uma autenticação federada com o ADFS, uma confiança OAuth, o serviço Perfis de Utilizador e uma aplicação Web com 2 zonas que contêm várias coleções de sites baseadas em caminhos e com nome de anfitrião. Nas máquinas virtuais do SharePoint, o Chocolatey é utilizado para instalar a versão mais recente do Notepad++, Visual Studio Code, Azure Data Studio, Fiddler, ULS Viewer e 7-Zip.

Definição de recurso do Terraform (fornecedor AzAPI)

O tipo de recurso virtualMachines/runCommands pode ser implementado com operações que visam:

  • Grupos de recursos

Para obter uma lista de propriedades alteradas em cada versão da API, veja registo de alterações.

Formato do recurso

Para criar um recurso Microsoft.Compute/virtualMachines/runCommands, adicione o seguinte Terraform ao seu modelo.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Compute/virtualMachines/runCommands@2021-03-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 propriedade

virtualMachines/runCommands

Nome Descrição Valor
tipo O tipo de recurso "Microsoft.Compute/virtualMachines/runCommands@2021-03-01"
name O nome do recurso cadeia (obrigatório)
localização Localização do recurso cadeia (obrigatório)
parent_id O ID do recurso que é o principal para este recurso. ID para recurso do tipo: virtualMachines
etiquetas Etiquetas de recursos Dicionário de nomes e valores de etiquetas.
propriedades Descreve as propriedades de um comando de execução de Máquina Virtual. VirtualMachineRunCommandProperties

VirtualMachineRunCommandProperties

Nome Descrição Valor
asyncExecution Opcional. Se estiver definido como verdadeiro, o aprovisionamento será concluído assim que o script for iniciado e não aguardará pela conclusão do script. bool
errorBlobUri Especifica o blob de armazenamento do Azure onde o fluxo de erros do script será carregado. string
outputBlobUri Especifica o blob de armazenamento do Azure onde o fluxo de saída do script será carregado. string
parâmetros Os parâmetros utilizados pelo script. RunCommandInputParameter[]
protectedParameters Os parâmetros utilizados pelo script. RunCommandInputParameter[]
runAsPassword Especifica a palavra-passe da conta de utilizador na VM ao executar o comando executar. string
runAsUser Especifica a conta de utilizador na VM ao executar o comando executar. string
source A origem do script de comandos de execução. VirtualMachineRunCommandScriptSource
timeoutInSeconds O tempo limite em segundos para executar o comando executar. int

ExecutarCommandInputParameter

Nome Descrição Valor
name O nome do parâmetro de comando de execução. cadeia (obrigatório)
valor O valor do parâmetro de comando de execução. cadeia (obrigatório)

VirtualMachineRunCommandScriptSource

Nome Descrição Valor
commandId Especifica um commandId de script incorporado predefinido. string
script Especifica o conteúdo do script a ser executado na VM. string
scriptUri Especifica a localização de transferência do script. string