Sdílet prostřednictvím


Microsoft.Compute virtualMachines/runCommands 2023-03-01

Definice prostředku Bicep

Typ prostředku virtualMachines/runCommands je možné nasadit s operacemi, které cílí:

Seznam změněných vlastností v jednotlivých verzích rozhraní API najdete v protokolu změn.

Formát prostředku

Pokud chcete vytvořit prostředek Microsoft.Compute/virtualMachines/runCommands, přidejte do šablony následující bicep.

resource symbolicname 'Microsoft.Compute/virtualMachines/runCommands@2023-03-01' = {
  parent: resourceSymbolicName
  location: 'string'
  name: 'string'
  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
  }
  tags: {
    {customized property}: 'string'
  }
}

Hodnoty vlastností

Microsoft.Compute/virtualMachines/runCommands

Jméno Popis Hodnota
umístění Umístění prostředku string (povinné)
Jméno Název prostředku string (povinné)
rodič V bicep můžete zadat nadřazený prostředek pro podřízený prostředek. Tuto vlastnost je potřeba přidat pouze v případě, že je podřízený prostředek deklarován mimo nadřazený prostředek.

Další informace najdete v tématu Podřízený prostředek mimo nadřazený prostředek.
Symbolický název prostředku typu: virtualMachines
vlastnosti Popisuje vlastnosti příkazu spuštění virtuálního počítače. VirtualMachineRunCommandProperties
visačky Značky prostředků Slovník názvů a hodnot značek Viz Značky v šablonách

Značky prostředků

Jméno Popis Hodnota

RunCommandInputParameter

Jméno Popis Hodnota
Jméno Název parametru příkazu run. string (povinné)
hodnota Hodnota parametru příkazu run. string (povinné)

RunCommandManagedIdentity

Jméno Popis Hodnota
clientId ID klienta (hodnota GUID) spravované identity přiřazené uživatelem Id objektu by se nemělo používat, pokud je k dispozici. řetězec
objectId ID objektu (hodnota GUID) spravované identity přiřazené uživatelem Id klienta by se nemělo používat, pokud je k dispozici. řetězec

VirtualMachineRunCommandProperties

Jméno Popis Hodnota
asyncExecution Volitelný. Pokud je hodnota true, zřizování se dokončí, jakmile se skript spustí a nečeká na dokončení skriptu. Bool
errorBlobManagedIdentity Spravovaná identita přiřazená uživatelem, která má přístup k objektu blob úložiště errorBlobUri. V případě identity přiřazené systémem použijte prázdný objekt. Ujistěte se, že spravovaná identita získala přístup k kontejneru objektu blob s přiřazením role Přispěvatel dat objektů blob služby Storage. V případě identity přiřazené uživatelem se ujistěte, že ji přidáte do identity virtuálního počítače. Další informace o spravované identitě a příkazu Spustit najdete v tématu https://aka.ms/ManagedIdentity a https://aka.ms/RunCommandManaged RunCommandManagedIdentity
errorBlobUri Určuje objekt blob úložiště Azure, kde se nahraje chybový stream skriptu. K poskytnutí přístupu k objektu blob použijte identifikátor URI SAS se čtením, připojením, vytvořením, přístupem k zápisu nebo spravovanou identitou. Projděte si parametr errorBlobManagedIdentity. řetězec
outputBlobManagedIdentity Spravovaná identita přiřazená uživatelem, která má přístup k výstupnímu objektu blob úložištěBlobUri. V případě identity přiřazené systémem použijte prázdný objekt. Ujistěte se, že spravovaná identita získala přístup k kontejneru objektu blob s přiřazením role Přispěvatel dat objektů blob služby Storage. V případě identity přiřazené uživatelem se ujistěte, že ji přidáte do identity virtuálního počítače. Další informace o spravované identitě a příkazu Spustit najdete v tématu https://aka.ms/ManagedIdentity a https://aka.ms/RunCommandManaged RunCommandManagedIdentity
outputBlobUri Určuje objekt blob úložiště Azure, ve kterém se nahraje výstupní datový proud skriptu. K poskytnutí přístupu k objektu blob použijte identifikátor URI SAS se čtením, připojením, vytvořením, přístupem k zápisu nebo spravovanou identitou. Projděte si výstupní parametrBlobManagedIdentity. řetězec
parametry Parametry používané skriptem. RunCommandInputParameter[]
protectedParameters Parametry používané skriptem. RunCommandInputParameter[]
runAsPassword Určuje heslo uživatelského účtu na virtuálním počítači při spuštění příkazu run. řetězec
runAsUser Určuje uživatelský účet na virtuálním počítači při spuštění příkazu spustit. řetězec
zdroj Zdroj skriptu příkazu run. VirtualMachineRunCommandScriptSource
timeoutInSeconds Časový limit v sekundách pro spuštění příkazu. Int
treatFailureAsDeploymentFailure Volitelný. Pokud je nastavená hodnota true, selhání ve skriptu selže nasazení a ProvisioningState se označí jako Neúspěšné. Pokud nastavíte hodnotu false, ProvisioningState bude odrážet pouze to, jestli byl příkaz spuštění spuštěný nebo ne platformou rozšíření, nezoznačuje, jestli skript selhal v případě selhání skriptu. Zobrazení spuštění příkazu instance v případě selhání skriptu zobrazit executionMessage, výstup, chyba: https://aka.ms/runcommandmanaged#get-execution-status-and-results Bool

VirtualMachineRunCommandScriptSource

Jméno Popis Hodnota
commandId Určuje commandId předdefinovaného předdefinovaného skriptu. řetězec
skript Určuje obsah skriptu, který se má na virtuálním počítači spustit. řetězec
scriptUri Určuje umístění stahování skriptu. Může to být identifikátor URI SAS objektu blob úložiště Azure s přístupem pro čtení nebo veřejným identifikátorem URI. řetězec
scriptUriManagedIdentity Spravovaná identita přiřazená uživatelem, která má přístup k identifikátoru scriptUri v případě objektu blob úložiště Azure. V případě identity přiřazené systémem použijte prázdný objekt. Ujistěte se, že objekt blob úložiště Azure existuje, a spravovaná identita má udělený přístup k kontejneru objektu blob s přiřazením role Čtenář dat objektů blob služby Storage. V případě identity přiřazené uživatelem se ujistěte, že ji přidáte do identity virtuálního počítače. Další informace o spravované identitě a příkazu Spustit najdete v tématu https://aka.ms/ManagedIdentity a https://aka.ms/RunCommandManaged. RunCommandManagedIdentity

Ukázky rychlého startu

Následující ukázky rychlého startu nasadí tento typ prostředku.

Soubor Bicep Popis
GitLab Omnibus Tato šablona zjednodušuje nasazení GitLab Omnibusu na virtuálním počítači s veřejným DNS s využitím DNS veřejné IP adresy. Využívá velikost Standard_F8s_v2 instance, která odpovídá referenční architektuře a podporuje až 1 000 uživatelů (20 RPS). Instance je předem nakonfigurovaná tak, aby používala protokol HTTPS s certifikátem Let's Encrypt pro zabezpečená připojení.
předplatné SharePointu / 2019 / 2016 plně nakonfigurované Vytvořte řadič domény, SQL Server 2022 a od 1 do 5 serverů, které hostují farmu předplatného SharePointu / 2019 / 2016 s rozsáhlou konfigurací, včetně důvěryhodného ověřování, profilů uživatelů s osobními weby, důvěryhodnosti OAuth (pomocí certifikátu), vyhrazeného webu IIS pro hostování doplňků s vysokou důvěryhodností atd... Nainstaluje se nejnovější verze klíčových softwaru (včetně Fiddler, vscode, np++, 7zip, ULS Viewer). Počítače SharePointu mají další vyladění, aby je bylo možné okamžitě použít (nástroje pro vzdálenou správu, vlastní zásady pro Edge a Chrome, klávesové zkratky atd.).

Definice prostředku šablony ARM

Typ prostředku virtualMachines/runCommands je možné nasadit s operacemi, které cílí:

Seznam změněných vlastností v jednotlivých verzích rozhraní API najdete v protokolu změn.

Formát prostředku

Pokud chcete vytvořit prostředek Microsoft.Compute/virtualMachines/runCommands, přidejte do šablony následující JSON.

{
  "type": "Microsoft.Compute/virtualMachines/runCommands",
  "apiVersion": "2023-03-01",
  "name": "string",
  "location": "string",
  "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"
  },
  "tags": {
    "{customized property}": "string"
  }
}

Hodnoty vlastností

Microsoft.Compute/virtualMachines/runCommands

Jméno Popis Hodnota
apiVersion Verze rozhraní API '2023-03-01'
umístění Umístění prostředku string (povinné)
Jméno Název prostředku string (povinné)
vlastnosti Popisuje vlastnosti příkazu spuštění virtuálního počítače. VirtualMachineRunCommandProperties
visačky Značky prostředků Slovník názvů a hodnot značek Viz Značky v šablonách
typ Typ prostředku Microsoft.Compute/virtualMachines/runCommands

Značky prostředků

Jméno Popis Hodnota

RunCommandInputParameter

Jméno Popis Hodnota
Jméno Název parametru příkazu run. string (povinné)
hodnota Hodnota parametru příkazu run. string (povinné)

RunCommandManagedIdentity

Jméno Popis Hodnota
clientId ID klienta (hodnota GUID) spravované identity přiřazené uživatelem Id objektu by se nemělo používat, pokud je k dispozici. řetězec
objectId ID objektu (hodnota GUID) spravované identity přiřazené uživatelem Id klienta by se nemělo používat, pokud je k dispozici. řetězec

VirtualMachineRunCommandProperties

Jméno Popis Hodnota
asyncExecution Volitelný. Pokud je hodnota true, zřizování se dokončí, jakmile se skript spustí a nečeká na dokončení skriptu. Bool
errorBlobManagedIdentity Spravovaná identita přiřazená uživatelem, která má přístup k objektu blob úložiště errorBlobUri. V případě identity přiřazené systémem použijte prázdný objekt. Ujistěte se, že spravovaná identita získala přístup k kontejneru objektu blob s přiřazením role Přispěvatel dat objektů blob služby Storage. V případě identity přiřazené uživatelem se ujistěte, že ji přidáte do identity virtuálního počítače. Další informace o spravované identitě a příkazu Spustit najdete v tématu https://aka.ms/ManagedIdentity a https://aka.ms/RunCommandManaged RunCommandManagedIdentity
errorBlobUri Určuje objekt blob úložiště Azure, kde se nahraje chybový stream skriptu. K poskytnutí přístupu k objektu blob použijte identifikátor URI SAS se čtením, připojením, vytvořením, přístupem k zápisu nebo spravovanou identitou. Projděte si parametr errorBlobManagedIdentity. řetězec
outputBlobManagedIdentity Spravovaná identita přiřazená uživatelem, která má přístup k výstupnímu objektu blob úložištěBlobUri. V případě identity přiřazené systémem použijte prázdný objekt. Ujistěte se, že spravovaná identita získala přístup k kontejneru objektu blob s přiřazením role Přispěvatel dat objektů blob služby Storage. V případě identity přiřazené uživatelem se ujistěte, že ji přidáte do identity virtuálního počítače. Další informace o spravované identitě a příkazu Spustit najdete v tématu https://aka.ms/ManagedIdentity a https://aka.ms/RunCommandManaged RunCommandManagedIdentity
outputBlobUri Určuje objekt blob úložiště Azure, ve kterém se nahraje výstupní datový proud skriptu. K poskytnutí přístupu k objektu blob použijte identifikátor URI SAS se čtením, připojením, vytvořením, přístupem k zápisu nebo spravovanou identitou. Projděte si výstupní parametrBlobManagedIdentity. řetězec
parametry Parametry používané skriptem. RunCommandInputParameter[]
protectedParameters Parametry používané skriptem. RunCommandInputParameter[]
runAsPassword Určuje heslo uživatelského účtu na virtuálním počítači při spuštění příkazu run. řetězec
runAsUser Určuje uživatelský účet na virtuálním počítači při spuštění příkazu spustit. řetězec
zdroj Zdroj skriptu příkazu run. VirtualMachineRunCommandScriptSource
timeoutInSeconds Časový limit v sekundách pro spuštění příkazu. Int
treatFailureAsDeploymentFailure Volitelný. Pokud je nastavená hodnota true, selhání ve skriptu selže nasazení a ProvisioningState se označí jako Neúspěšné. Pokud nastavíte hodnotu false, ProvisioningState bude odrážet pouze to, jestli byl příkaz spuštění spuštěný nebo ne platformou rozšíření, nezoznačuje, jestli skript selhal v případě selhání skriptu. Zobrazení spuštění příkazu instance v případě selhání skriptu zobrazit executionMessage, výstup, chyba: https://aka.ms/runcommandmanaged#get-execution-status-and-results Bool

VirtualMachineRunCommandScriptSource

Jméno Popis Hodnota
commandId Určuje commandId předdefinovaného předdefinovaného skriptu. řetězec
skript Určuje obsah skriptu, který se má na virtuálním počítači spustit. řetězec
scriptUri Určuje umístění stahování skriptu. Může to být identifikátor URI SAS objektu blob úložiště Azure s přístupem pro čtení nebo veřejným identifikátorem URI. řetězec
scriptUriManagedIdentity Spravovaná identita přiřazená uživatelem, která má přístup k identifikátoru scriptUri v případě objektu blob úložiště Azure. V případě identity přiřazené systémem použijte prázdný objekt. Ujistěte se, že objekt blob úložiště Azure existuje, a spravovaná identita má udělený přístup k kontejneru objektu blob s přiřazením role Čtenář dat objektů blob služby Storage. V případě identity přiřazené uživatelem se ujistěte, že ji přidáte do identity virtuálního počítače. Další informace o spravované identitě a příkazu Spustit najdete v tématu https://aka.ms/ManagedIdentity a https://aka.ms/RunCommandManaged. RunCommandManagedIdentity

Šablony pro rychlý start

Následující šablony pro rychlý start nasazují tento typ prostředku.

Šablona Popis
GitLab Omnibus

Nasazení do Azure
Tato šablona zjednodušuje nasazení GitLab Omnibusu na virtuálním počítači s veřejným DNS s využitím DNS veřejné IP adresy. Využívá velikost Standard_F8s_v2 instance, která odpovídá referenční architektuře a podporuje až 1 000 uživatelů (20 RPS). Instance je předem nakonfigurovaná tak, aby používala protokol HTTPS s certifikátem Let's Encrypt pro zabezpečená připojení.
předplatné SharePointu / 2019 / 2016 plně nakonfigurované

Nasazení do Azure
Vytvořte řadič domény, SQL Server 2022 a od 1 do 5 serverů, které hostují farmu předplatného SharePointu / 2019 / 2016 s rozsáhlou konfigurací, včetně důvěryhodného ověřování, profilů uživatelů s osobními weby, důvěryhodnosti OAuth (pomocí certifikátu), vyhrazeného webu IIS pro hostování doplňků s vysokou důvěryhodností atd... Nainstaluje se nejnovější verze klíčových softwaru (včetně Fiddler, vscode, np++, 7zip, ULS Viewer). Počítače SharePointu mají další vyladění, aby je bylo možné okamžitě použít (nástroje pro vzdálenou správu, vlastní zásady pro Edge a Chrome, klávesové zkratky atd.).

Definice prostředku Terraformu (poskytovatel AzAPI)

Typ prostředku virtualMachines/runCommands je možné nasadit s operacemi, které cílí:

  • Skupina prostředků

Seznam změněných vlastností v jednotlivých verzích rozhraní API najdete v protokolu změn.

Formát prostředku

Pokud chcete vytvořit prostředek Microsoft.Compute/virtualMachines/runCommands, přidejte do šablony následující Terraform.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Compute/virtualMachines/runCommands@2023-03-01"
  name = "string"
  location = "string"
  tags = {
    {customized property} = "string"
  }
  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
    }
  })
}

Hodnoty vlastností

Microsoft.Compute/virtualMachines/runCommands

Jméno Popis Hodnota
umístění Umístění prostředku string (povinné)
Jméno Název prostředku string (povinné)
parent_id ID prostředku, který je nadřazený pro tento prostředek. ID prostředku typu: virtualMachines
vlastnosti Popisuje vlastnosti příkazu spuštění virtuálního počítače. VirtualMachineRunCommandProperties
visačky Značky prostředků Slovník názvů a hodnot značek
typ Typ prostředku Microsoft.Compute/virtualMachines/runCommands@2023-03-01

Značky prostředků

Jméno Popis Hodnota

RunCommandInputParameter

Jméno Popis Hodnota
Jméno Název parametru příkazu run. string (povinné)
hodnota Hodnota parametru příkazu run. string (povinné)

RunCommandManagedIdentity

Jméno Popis Hodnota
clientId ID klienta (hodnota GUID) spravované identity přiřazené uživatelem Id objektu by se nemělo používat, pokud je k dispozici. řetězec
objectId ID objektu (hodnota GUID) spravované identity přiřazené uživatelem Id klienta by se nemělo používat, pokud je k dispozici. řetězec

VirtualMachineRunCommandProperties

Jméno Popis Hodnota
asyncExecution Volitelný. Pokud je hodnota true, zřizování se dokončí, jakmile se skript spustí a nečeká na dokončení skriptu. Bool
errorBlobManagedIdentity Spravovaná identita přiřazená uživatelem, která má přístup k objektu blob úložiště errorBlobUri. V případě identity přiřazené systémem použijte prázdný objekt. Ujistěte se, že spravovaná identita získala přístup k kontejneru objektu blob s přiřazením role Přispěvatel dat objektů blob služby Storage. V případě identity přiřazené uživatelem se ujistěte, že ji přidáte do identity virtuálního počítače. Další informace o spravované identitě a příkazu Spustit najdete v tématu https://aka.ms/ManagedIdentity a https://aka.ms/RunCommandManaged RunCommandManagedIdentity
errorBlobUri Určuje objekt blob úložiště Azure, kde se nahraje chybový stream skriptu. K poskytnutí přístupu k objektu blob použijte identifikátor URI SAS se čtením, připojením, vytvořením, přístupem k zápisu nebo spravovanou identitou. Projděte si parametr errorBlobManagedIdentity. řetězec
outputBlobManagedIdentity Spravovaná identita přiřazená uživatelem, která má přístup k výstupnímu objektu blob úložištěBlobUri. V případě identity přiřazené systémem použijte prázdný objekt. Ujistěte se, že spravovaná identita získala přístup k kontejneru objektu blob s přiřazením role Přispěvatel dat objektů blob služby Storage. V případě identity přiřazené uživatelem se ujistěte, že ji přidáte do identity virtuálního počítače. Další informace o spravované identitě a příkazu Spustit najdete v tématu https://aka.ms/ManagedIdentity a https://aka.ms/RunCommandManaged RunCommandManagedIdentity
outputBlobUri Určuje objekt blob úložiště Azure, ve kterém se nahraje výstupní datový proud skriptu. K poskytnutí přístupu k objektu blob použijte identifikátor URI SAS se čtením, připojením, vytvořením, přístupem k zápisu nebo spravovanou identitou. Projděte si výstupní parametrBlobManagedIdentity. řetězec
parametry Parametry používané skriptem. RunCommandInputParameter[]
protectedParameters Parametry používané skriptem. RunCommandInputParameter[]
runAsPassword Určuje heslo uživatelského účtu na virtuálním počítači při spuštění příkazu run. řetězec
runAsUser Určuje uživatelský účet na virtuálním počítači při spuštění příkazu spustit. řetězec
zdroj Zdroj skriptu příkazu run. VirtualMachineRunCommandScriptSource
timeoutInSeconds Časový limit v sekundách pro spuštění příkazu. Int
treatFailureAsDeploymentFailure Volitelný. Pokud je nastavená hodnota true, selhání ve skriptu selže nasazení a ProvisioningState se označí jako Neúspěšné. Pokud nastavíte hodnotu false, ProvisioningState bude odrážet pouze to, jestli byl příkaz spuštění spuštěný nebo ne platformou rozšíření, nezoznačuje, jestli skript selhal v případě selhání skriptu. Zobrazení spuštění příkazu instance v případě selhání skriptu zobrazit executionMessage, výstup, chyba: https://aka.ms/runcommandmanaged#get-execution-status-and-results Bool

VirtualMachineRunCommandScriptSource

Jméno Popis Hodnota
commandId Určuje commandId předdefinovaného předdefinovaného skriptu. řetězec
skript Určuje obsah skriptu, který se má na virtuálním počítači spustit. řetězec
scriptUri Určuje umístění stahování skriptu. Může to být identifikátor URI SAS objektu blob úložiště Azure s přístupem pro čtení nebo veřejným identifikátorem URI. řetězec
scriptUriManagedIdentity Spravovaná identita přiřazená uživatelem, která má přístup k identifikátoru scriptUri v případě objektu blob úložiště Azure. V případě identity přiřazené systémem použijte prázdný objekt. Ujistěte se, že objekt blob úložiště Azure existuje, a spravovaná identita má udělený přístup k kontejneru objektu blob s přiřazením role Čtenář dat objektů blob služby Storage. V případě identity přiřazené uživatelem se ujistěte, že ji přidáte do identity virtuálního počítače. Další informace o spravované identitě a příkazu Spustit najdete v tématu https://aka.ms/ManagedIdentity a https://aka.ms/RunCommandManaged. RunCommandManagedIdentity