Condividi tramite

Microsoft.Compute virtualMachines/runCommands

  • Articolo

Definizione di risorsa Bicep

Il tipo di risorsa virtualMachines/runCommands può essere distribuito con operazioni destinate:

Per un elenco delle proprietà modificate in ogni versione dell'API, vedere log delle modifiche.

Formato di risorsa

Per creare una risorsa Microsoft.Compute/virtualMachines/runCommands, aggiungere il bicep seguente al modello.

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

Valori delle proprietà

virtualMachines/runCommands

Nome Descrizione valore
name Nome della risorsa

Vedere come impostare nomi e tipi per le risorse figlio in Bicep.		 stringa (obbligatoria)
posizione Posizione risorsa stringa (obbligatoria)
tags Tag delle risorse Dizionario dei nomi e dei valori dei tag. Vedere Tag nei modelli
padre In Bicep è possibile specificare la risorsa padre per una risorsa figlio. È necessario aggiungere questa proprietà solo quando la risorsa figlio viene dichiarata all'esterno della risorsa padre.

Per altre informazioni, vedere Risorsa figlio esterna alla risorsa padre.		 Nome simbolico per la risorsa di tipo: virtualMachines
properties Descrive le proprietà di un comando di esecuzione di una macchina virtuale. VirtualMachineRunCommandProperties

VirtualMachineRunCommandProperties

Nome Descrizione Valore
asyncExecution facoltativo. Se impostato su true, il provisioning verrà completato non appena viene avviato lo script e non attenderà il completamento dello script. bool
errorBlobManagedIdentity Identità gestita assegnata dall'utente che ha accesso al BLOB di archiviazione errorBlobUri. Usare un oggetto vuoto nel caso di identità assegnata dal sistema. Assicurarsi che l'identità gestita sia stata assegnata al contenitore del BLOB con l'assegnazione di ruolo "Collaboratore dati BLOB di archiviazione". Nel caso dell'identità assegnata dall'utente, assicurarsi di aggiungerlo sotto l'identità della macchina virtuale. Per altre informazioni sull'identità gestita ed esegui comando, fare riferimento https://aka.ms/ManagedIdentity e https://aka.ms/RunCommandManaged RunCommandManagedIdentity
errorBlobUri Specifica il BLOB di archiviazione di Azure in cui verrà caricato il flusso di errori di script. Usare un URI di firma di accesso condiviso con lettura, accodamento, creazione, accesso in scrittura O usare l'identità gestita per fornire l'accesso alla macchina virtuale al BLOB. Fare riferimento al parametro errorBlobManagedIdentity. string
outputBlobManagedIdentity Identità gestita assegnata dall'utente che ha accesso al BLOB di archiviazione outputBlobUri. Usare un oggetto vuoto nel caso di identità assegnata dal sistema. Assicurarsi che l'identità gestita sia stata assegnata al contenitore del BLOB con l'assegnazione di ruolo "Collaboratore dati BLOB di archiviazione". Nel caso dell'identità assegnata dall'utente, assicurarsi di aggiungerlo sotto l'identità della macchina virtuale. Per altre informazioni sull'identità gestita ed esegui comando, fare riferimento https://aka.ms/ManagedIdentity e https://aka.ms/RunCommandManaged RunCommandManagedIdentity
outputBlobUri Specifica il BLOB di archiviazione di Azure in cui verrà caricato il flusso di output dello script. Usare un URI di firma di accesso condiviso con lettura, accodamento, creazione, accesso in scrittura O usare l'identità gestita per fornire l'accesso alla macchina virtuale al BLOB. Fare riferimento al parametro outputBlobManagedIdentity. string
parametri Parametri usati dallo script. RunCommandInputParameter[]
protectedParameters Parametri usati dallo script. RunCommandInputParameter[]
runAsPassword Specifica la password dell'account utente nella macchina virtuale durante l'esecuzione del comando di esecuzione. string
runAsUser Specifica l'account utente nella macchina virtuale durante l'esecuzione del comando di esecuzione. string
source Origine dello script di comando di esecuzione. VirtualMachineRunCommandScriptSource
timeoutInSeconds Timeout in secondi per eseguire il comando di esecuzione. INT
treatFailureAsDeploymentFailure facoltativo. Se impostato su true, qualsiasi errore nello script avrà esito negativo nella distribuzione e ProvisioningState verrà contrassegnato come Non riuscito. Se impostato su false, ProvisioningState riflette solo se il comando di esecuzione è stato eseguito o meno dalla piattaforma estensioni, non indica se lo script non è riuscito in caso di errori di script. Vedere la visualizzazione dell'istanza del comando di esecuzione in caso di errori di script per visualizzare executionMessage, output, error: https://aka.ms/runcommandmanaged#get-execution-status-and-results bool

RunCommandManagedIdentity

Nome Descrizione Valore
clientId ID client (valore GUID) dell'identità gestita assegnata dall'utente. ObjectId non deve essere usato se specificato. string
objectId ID oggetto (valore GUID) dell'identità gestita assegnata dall'utente. ClientId non deve essere usato se specificato. string

RunCommandInputParameter

Nome Descrizione valore
name Nome del parametro del comando di esecuzione. stringa (obbligatorio)
Valore Valore del parametro del comando run. stringa (obbligatorio)

VirtualMachineRunCommandScriptSource

Nome Descrizione Valore
Commandid Specifica un commandId dello script predefinito predefinito. string
script Specifica il contenuto dello script da eseguire nella macchina virtuale. string
scriptUri Specifica il percorso di download dello script. Può trattarsi di un URI di firma di accesso condiviso di un BLOB di archiviazione di Azure con accesso in lettura o URI pubblico. string
scriptUriManagedIdentity Identità gestita assegnata dall'utente che ha accesso a scriptUri in caso di BLOB di archiviazione di Azure. Usare un oggetto vuoto in caso di identità assegnata dal sistema. Assicurarsi che il BLOB di archiviazione di Azure esista e che all'identità gestita sia stato concesso l'accesso al contenitore del BLOB con l'assegnazione di ruolo "Lettore dati BLOB di archiviazione". In caso di identità assegnata dall'utente, assicurarsi di aggiungerla con l'identità della macchina virtuale. Per altre informazioni sull'identità gestita ed esegui comando, vedere https://aka.ms/ManagedIdentity e https://aka.ms/RunCommandManaged. RunCommandManagedIdentity

Modelli di avvio rapido

I modelli di avvio rapido seguenti distribuiscono questo tipo di risorsa.

Modello Descrizione
Sottoscrizione di SharePoint / 2019 / 2016 / 2013 tutti configurati

Distribuisci in Azure		 Questo modello crea una farm di SharePoint Subscription/2019/2016/2013 con una configurazione estesa che richiederebbe età per eseguire manualmente, inclusa un'autenticazione federata con ADFS, un trust OAuth, il servizio Profili utente e un'applicazione Web con 2 zone che contengono più raccolte siti basate su percorsi e denominati host. Nelle macchine virtuali di SharePoint, Chocolatey viene usato per installare la versione più recente di Notepad++, Visual Studio Code, Azure Data Studio, Fiddler, ULS Viewer e 7-Zip.

Definizione di risorsa del modello di Resource Manager

Il tipo di risorsa virtualMachines/runCommands può essere distribuito con operazioni destinate:

Per un elenco delle proprietà modificate in ogni versione dell'API, vedere Log delle modifiche.

Formato di risorsa

Per creare una risorsa Microsoft.Compute/virtualMachines/runCommands, aggiungere il codice JSON seguente al modello.

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

Valori delle proprietà

virtualMachines/runCommands

Nome Descrizione Valore
tipo Tipo di risorsa 'Microsoft.Compute/virtualMachines/runCommands'
apiVersion Versione dell'API della risorsa '2023-09-01'
name Nome della risorsa

Informazioni su come impostare nomi e tipi per le risorse figlio nei modelli di Resource Manager JSON.		 stringa (obbligatorio)
posizione Posizione risorsa stringa (obbligatorio)
tags Tag delle risorse Dizionario di nomi e valori di tag. Vedere Tag nei modelli
properties Descrive le proprietà di un comando run di una macchina virtuale. VirtualMachineRunCommandProperties

VirtualMachineRunCommandProperties

Nome Descrizione Valore
asyncExecution facoltativo. Se impostato su true, il provisioning verrà completato non appena viene avviato lo script e non attenderà il completamento dello script. bool
errorBlobManagedIdentity Identità gestita assegnata dall'utente che ha accesso al BLOB di archiviazione errorBlobUri. Usare un oggetto vuoto in caso di identità assegnata dal sistema. Assicurarsi che all'identità gestita sia stato concesso l'accesso al contenitore del BLOB con l'assegnazione di ruolo "Collaboratore ai dati dei BLOB di archiviazione". In caso di identità assegnata dall'utente, assicurarsi di aggiungerla con l'identità della macchina virtuale. Per altre informazioni sull'identità gestita ed esegui comando, vedere https://aka.ms/ManagedIdentity e https://aka.ms/RunCommandManaged RunCommandManagedIdentity
errorBlobUri Specifica il BLOB di archiviazione di Azure in cui verrà caricato il flusso di errori di script. Usare un URI di firma di accesso condiviso con lettura, accodamento, creazione, accesso in scrittura O usare l'identità gestita per fornire l'accesso alla macchina virtuale al BLOB. Fare riferimento al parametro errorBlobManagedIdentity. string
outputBlobManagedIdentity Identità gestita assegnata dall'utente che ha accesso al BLOB di archiviazione outputBlobUri. Usare un oggetto vuoto nel caso di identità assegnata dal sistema. Assicurarsi che l'identità gestita sia stata assegnata al contenitore del BLOB con l'assegnazione di ruolo "Collaboratore dati BLOB di archiviazione". Nel caso dell'identità assegnata dall'utente, assicurarsi di aggiungerlo sotto l'identità della macchina virtuale. Per altre informazioni sull'identità gestita ed esegui comando, fare riferimento https://aka.ms/ManagedIdentity e https://aka.ms/RunCommandManaged RunCommandManagedIdentity
outputBlobUri Specifica il BLOB di archiviazione di Azure in cui verrà caricato il flusso di output dello script. Usare un URI di firma di accesso condiviso con lettura, accodamento, creazione, accesso in scrittura O usare l'identità gestita per fornire l'accesso alla macchina virtuale al BLOB. Fare riferimento al parametro outputBlobManagedIdentity. string
parametri Parametri usati dallo script. RunCommandInputParameter[]
protectedParameters Parametri usati dallo script. RunCommandInputParameter[]
runAsPassword Specifica la password dell'account utente nella macchina virtuale durante l'esecuzione del comando di esecuzione. string
runAsUser Specifica l'account utente nella macchina virtuale durante l'esecuzione del comando di esecuzione. string
source Origine dello script di comando di esecuzione. VirtualMachineRunCommandScriptSource
timeoutInSeconds Timeout in secondi per eseguire il comando di esecuzione. INT
treatFailureAsDeploymentFailure facoltativo. Se impostato su true, qualsiasi errore nello script avrà esito negativo nella distribuzione e ProvisioningState verrà contrassegnato come Non riuscito. Se impostato su false, ProvisioningState riflette solo se il comando di esecuzione è stato eseguito o meno dalla piattaforma estensioni, non indica se lo script non è riuscito in caso di errori di script. Vedere la visualizzazione dell'istanza del comando di esecuzione in caso di errori di script per visualizzare executionMessage, output, error: https://aka.ms/runcommandmanaged#get-execution-status-and-results bool

RunCommandManagedIdentity

Nome Descrizione Valore
clientId ID client (valore GUID) dell'identità gestita assegnata dall'utente. ObjectId non deve essere usato se viene specificato. string
objectId ID oggetto (valore GUID) dell'identità gestita assegnata dall'utente. ClientId non deve essere usato se viene specificato. string

RunCommandInputParameter

Nome Descrizione valore
name Nome del parametro di comando di esecuzione. stringa (obbligatoria)
Valore Valore del parametro del comando di esecuzione. stringa (obbligatoria)

VirtualMachineRunCommandScriptSource

Nome Descrizione Valore
Commandid Specifica un commandId dello script predefinito. string
script Specifica il contenuto dello script da eseguire nella macchina virtuale. string
scriptUri Specifica il percorso di download dello script. Può essere URI di firma di accesso condiviso di un BLOB di archiviazione di Azure con accesso in lettura o URI pubblico. string
scriptUriManagedIdentity Identità gestita assegnata dall'utente che ha accesso a scriptUri nel caso di BLOB di archiviazione di Azure. Usare un oggetto vuoto nel caso di identità assegnata dal sistema. Assicurarsi che il BLOB di archiviazione di Azure esista e che l'identità gestita sia stata assegnata al contenitore del BLOB con l'assegnazione di ruolo "Lettore dati BLOB di archiviazione". Nel caso dell'identità assegnata dall'utente, assicurarsi di aggiungerlo sotto l'identità della macchina virtuale. Per altre informazioni sull'identità gestita ed esegui comando, fare riferimento https://aka.ms/ManagedIdentity e https://aka.ms/RunCommandManaged. RunCommandManagedIdentity

Modelli di avvio rapido

I modelli di avvio rapido seguenti distribuiscono questo tipo di risorsa.

Modello Descrizione
Sottoscrizione di SharePoint / 2019 / 2016 / 2013 tutti configurati

Distribuisci in Azure		 Questo modello crea una farm sharePoint Subscription/2019/2016/2013 con una configurazione estesa che richiederebbe età per eseguire manualmente, inclusa un'autenticazione federata con ADFS, un trust OAuth, il servizio Profili utente e un'applicazione Web con 2 zone che contiene più raccolte siti basate su percorsi e denominati host. Nelle macchine virtuali sharePoint, Chocolatey viene usato per installare la versione più recente di Notepad++, Visual Studio Code, Azure Data Studio, Fiddler, ULS Viewer e 7-Zip.

Definizione della risorsa Terraform (provider AzAPI)

Il tipo di risorsa virtualMachines/runCommands può essere distribuito con operazioni destinate:

  • Gruppi di risorse

Per un elenco delle proprietà modificate in ogni versione dell'API, vedere log delle modifiche.

Formato di risorsa

Per creare una risorsa Microsoft.Compute/virtualMachines/runCommands, aggiungere il codice Terraform seguente al modello.

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

Valori delle proprietà

virtualMachines/runCommands

Nome Descrizione Valore
tipo Tipo di risorsa "Microsoft.Compute/virtualMachines/runCommands@2023-09-01"
name Nome della risorsa stringa (obbligatorio)
posizione Posizione risorsa stringa (obbligatorio)
parent_id ID della risorsa padre per questa risorsa. ID per la risorsa di tipo: virtualMachines
tags Tag delle risorse Dizionario di nomi e valori di tag.
properties Descrive le proprietà di un comando run di una macchina virtuale. VirtualMachineRunCommandProperties

VirtualMachineRunCommandProperties

Nome Descrizione Valore
asyncExecution facoltativo. Se impostato su true, il provisioning verrà completato non appena viene avviato lo script e non attenderà il completamento dello script. bool
errorBlobManagedIdentity Identità gestita assegnata dall'utente che ha accesso al BLOB di archiviazione errorBlobUri. Usare un oggetto vuoto in caso di identità assegnata dal sistema. Assicurarsi che all'identità gestita sia stato concesso l'accesso al contenitore del BLOB con l'assegnazione di ruolo "Collaboratore ai dati dei BLOB di archiviazione". In caso di identità assegnata dall'utente, assicurarsi di aggiungerla con l'identità della macchina virtuale. Per altre informazioni sull'identità gestita ed esegui comando, vedere https://aka.ms/ManagedIdentity e https://aka.ms/RunCommandManaged RunCommandManagedIdentity
errorBlobUri Specifica il BLOB di archiviazione di Azure in cui verrà caricato il flusso di errori dello script. Usare un URI di firma di accesso condiviso con lettura, aggiunta, creazione, accesso in scrittura o uso dell'identità gestita per fornire alla macchina virtuale l'accesso al BLOB. Fare riferimento al parametro errorBlobManagedIdentity. string
outputBlobManagedIdentity Identità gestita assegnata dall'utente che ha accesso al BLOB di archiviazione outputBlobUri. Usare un oggetto vuoto in caso di identità assegnata dal sistema. Assicurarsi che all'identità gestita sia stato concesso l'accesso al contenitore del BLOB con l'assegnazione di ruolo "Collaboratore ai dati dei BLOB di archiviazione". In caso di identità assegnata dall'utente, assicurarsi di aggiungerla con l'identità della macchina virtuale. Per altre informazioni sull'identità gestita ed esegui comando, vedere https://aka.ms/ManagedIdentity e https://aka.ms/RunCommandManaged RunCommandManagedIdentity
outputBlobUri Specifica il BLOB di archiviazione di Azure in cui verrà caricato il flusso di output dello script. Usare un URI di firma di accesso condiviso con lettura, aggiunta, creazione, accesso in scrittura o uso dell'identità gestita per fornire alla macchina virtuale l'accesso al BLOB. Fare riferimento al parametro outputBlobManagedIdentity. string
parametri Parametri utilizzati dallo script. RunCommandInputParameter[]
protectedParameters Parametri utilizzati dallo script. RunCommandInputParameter[]
runAsPassword Specifica la password dell'account utente nella macchina virtuale quando si esegue il comando di esecuzione. string
runAsUser Specifica l'account utente nella macchina virtuale durante l'esecuzione del comando di esecuzione. string
source Origine dello script del comando di esecuzione. VirtualMachineRunCommandScriptSource
timeoutInSeconds Timeout in secondi per eseguire il comando run. INT
treatFailureAsDeploymentFailure facoltativo. Se impostato su true, qualsiasi errore nello script non riuscirà la distribuzione e ProvisioningState verrà contrassegnato come Non riuscito. Se impostato su false, ProvisioningState riflette solo se il comando di esecuzione è stato eseguito o meno dalla piattaforma delle estensioni, non indicherebbe se lo script non è riuscito in caso di errori di script. Vedere la visualizzazione dell'istanza del comando di esecuzione in caso di errori di script per visualizzare executionMessage, output, error: https://aka.ms/runcommandmanaged#get-execution-status-and-results bool

RunCommandManagedIdentity

Nome Descrizione Valore
clientId ID client (valore GUID) dell'identità gestita assegnata dall'utente. ObjectId non deve essere usato se specificato. string
objectId ID oggetto (valore GUID) dell'identità gestita assegnata dall'utente. ClientId non deve essere usato se specificato. string

RunCommandInputParameter

Nome Descrizione valore
name Nome del parametro del comando di esecuzione. stringa (obbligatorio)
Valore Valore del parametro del comando run. stringa (obbligatorio)

VirtualMachineRunCommandScriptSource

Nome Descrizione Valore
Commandid Specifica un commandId dello script predefinito. string
script Specifica il contenuto dello script da eseguire nella macchina virtuale. string
scriptUri Specifica il percorso di download dello script. Può essere URI di firma di accesso condiviso di un BLOB di archiviazione di Azure con accesso in lettura o URI pubblico. string
scriptUriManagedIdentity Identità gestita assegnata dall'utente che ha accesso a scriptUri nel caso di BLOB di archiviazione di Azure. Usare un oggetto vuoto nel caso di identità assegnata dal sistema. Assicurarsi che il BLOB di archiviazione di Azure esista e che l'identità gestita sia stata assegnata al contenitore del BLOB con l'assegnazione di ruolo "Lettore dati BLOB di archiviazione". Nel caso dell'identità assegnata dall'utente, assicurarsi di aggiungerlo sotto l'identità della macchina virtuale. Per altre informazioni sull'identità gestita ed esegui comando, fare riferimento https://aka.ms/ManagedIdentity e https://aka.ms/RunCommandManaged. RunCommandManagedIdentity