Udostępnij za pośrednictwem


Microsoft.Compute virtualMachines/runCommands 2022-03-01

Definicja zasobu Bicep

Typ zasobu virtualMachines/runCommands można wdrożyć przy użyciu operacji docelowych:

Aby uzyskać listę zmienionych właściwości w każdej wersji interfejsu API, zobacz dziennika zmian.

Format zasobu

Aby utworzyć zasób Microsoft.Compute/virtualMachines/runCommands, dodaj następujący kod Bicep do szablonu.

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'
  }
}

Wartości właściwości

Microsoft.Compute/virtualMachines/runCommands

Nazwa Opis Wartość
lokalizacja Lokalizacja zasobu ciąg (wymagany)
nazwa Nazwa zasobu ciąg (wymagany)
rodzic W Bicep można określić zasób nadrzędny dla zasobu podrzędnego. Tę właściwość należy dodać tylko wtedy, gdy zasób podrzędny jest zadeklarowany poza zasobem nadrzędnym.

Aby uzyskać więcej informacji, zobacz Zasób podrzędny poza zasobem nadrzędnym.
Nazwa symboliczna zasobu typu: virtualMachines
Właściwości Opisuje właściwości polecenia uruchamiania maszyny wirtualnej. VirtualMachineRunCommandProperties
Tagi Tagi zasobów Słownik nazw tagów i wartości. Zobacz tagi w szablonach

Tagi zasobów

Nazwa Opis Wartość

RunCommandInputParameter

Nazwa Opis Wartość
nazwa Nazwa parametru polecenia uruchamiania. ciąg (wymagany)
wartość Wartość parametru polecenia uruchomienia. ciąg (wymagany)

VirtualMachineRunCommandProperties

Nazwa Opis Wartość
asyncExecution Fakultatywny. Jeśli ustawiono wartość true, aprowizacja zostanie ukończona natychmiast po uruchomieniu skryptu i nie będzie czekać na ukończenie skryptu. Bool
errorBlobUri Określa obiekt blob usługi Azure Storage, w którym zostanie przekazany strumień błędów skryptu. struna
outputBlobUri Określa obiekt blob usługi Azure Storage, w którym zostanie przekazany strumień wyjściowy skryptu. struna
Parametry Parametry używane przez skrypt. RunCommandInputParameter[]
protectedParameters Parametry używane przez skrypt. RunCommandInputParameter[]
runAsPassword Określa hasło konta użytkownika na maszynie wirtualnej podczas wykonywania polecenia uruchamiania. struna
runAsUser Określa konto użytkownika na maszynie wirtualnej podczas wykonywania polecenia uruchamiania. struna
źródło Źródło skryptu polecenia uruchamiania. VirtualMachineRunCommandScriptSource
timeoutInSeconds Limit czasu w sekundach do wykonania polecenia uruchomienia. Int

VirtualMachineRunCommandScriptSource

Nazwa Opis Wartość
commandId Określa identyfikator polecenia wstępnie zdefiniowanego wbudowanego skryptu. struna
skrypt Określa zawartość skryptu do wykonania na maszynie wirtualnej. struna
scriptUri Określa lokalizację pobierania skryptu. struna

Przykłady z przewodnika Szybki start

W poniższych przykładach szybkiego startu wdrożono ten typ zasobu.

Plik Bicep Opis
GitLab Omnibus Ten szablon upraszcza wdrażanie narzędzia GitLab Omnibus na maszynie wirtualnej z publicznym systemem DNS, wykorzystując system DNS publicznego adresu IP. Wykorzystuje on rozmiar wystąpienia Standard_F8s_v2, który jest zgodny z architekturą referencyjną i obsługuje maksymalnie 1000 użytkowników (20 RPS). Wystąpienie jest wstępnie skonfigurowane do używania protokołu HTTPS z certyfikatem Let's Encrypt na potrzeby bezpiecznych połączeń.
subskrypcja programu SharePoint / 2019 / 2016 w pełni skonfigurowane Utwórz kontroler domeny, farmę programu SQL Server 2022 i od 1 do 5 serwerów hostująca subskrypcję programu SharePoint / 2019 / 2016 z rozbudowaną konfiguracją, w tym zaufane uwierzytelnianie, profile użytkowników z witrynami osobistymi, zaufanie OAuth (przy użyciu certyfikatu), dedykowaną witrynę usług IIS do hostowania dodatków o wysokim zaufaniu itp. Zainstalowano najnowszą wersję oprogramowania kluczy (w tym programu Fiddler, vscode, np++, 7zip, ULS Viewer). Maszyny programu SharePoint mają dodatkowe dostrajanie, aby były natychmiast użyteczne (narzędzia administracji zdalnej, niestandardowe zasady dla przeglądarki Edge i Chrome, skróty itp.).

Definicja zasobu szablonu usługi ARM

Typ zasobu virtualMachines/runCommands można wdrożyć przy użyciu operacji docelowych:

Aby uzyskać listę zmienionych właściwości w każdej wersji interfejsu API, zobacz dziennika zmian.

Format zasobu

Aby utworzyć zasób Microsoft.Compute/virtualMachines/runCommands, dodaj następujący kod JSON do szablonu.

{
  "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"
  }
}

Wartości właściwości

Microsoft.Compute/virtualMachines/runCommands

Nazwa Opis Wartość
apiVersion Wersja interfejsu API '2022-03-01'
lokalizacja Lokalizacja zasobu ciąg (wymagany)
nazwa Nazwa zasobu ciąg (wymagany)
Właściwości Opisuje właściwości polecenia uruchamiania maszyny wirtualnej. VirtualMachineRunCommandProperties
Tagi Tagi zasobów Słownik nazw tagów i wartości. Zobacz tagi w szablonach
typ Typ zasobu "Microsoft.Compute/virtualMachines/runCommands"

Tagi zasobów

Nazwa Opis Wartość

RunCommandInputParameter

Nazwa Opis Wartość
nazwa Nazwa parametru polecenia uruchamiania. ciąg (wymagany)
wartość Wartość parametru polecenia uruchomienia. ciąg (wymagany)

VirtualMachineRunCommandProperties

Nazwa Opis Wartość
asyncExecution Fakultatywny. Jeśli ustawiono wartość true, aprowizacja zostanie ukończona natychmiast po uruchomieniu skryptu i nie będzie czekać na ukończenie skryptu. Bool
errorBlobUri Określa obiekt blob usługi Azure Storage, w którym zostanie przekazany strumień błędów skryptu. struna
outputBlobUri Określa obiekt blob usługi Azure Storage, w którym zostanie przekazany strumień wyjściowy skryptu. struna
Parametry Parametry używane przez skrypt. RunCommandInputParameter[]
protectedParameters Parametry używane przez skrypt. RunCommandInputParameter[]
runAsPassword Określa hasło konta użytkownika na maszynie wirtualnej podczas wykonywania polecenia uruchamiania. struna
runAsUser Określa konto użytkownika na maszynie wirtualnej podczas wykonywania polecenia uruchamiania. struna
źródło Źródło skryptu polecenia uruchamiania. VirtualMachineRunCommandScriptSource
timeoutInSeconds Limit czasu w sekundach do wykonania polecenia uruchomienia. Int

VirtualMachineRunCommandScriptSource

Nazwa Opis Wartość
commandId Określa identyfikator polecenia wstępnie zdefiniowanego wbudowanego skryptu. struna
skrypt Określa zawartość skryptu do wykonania na maszynie wirtualnej. struna
scriptUri Określa lokalizację pobierania skryptu. struna

Szablony szybkiego startu

Następujące szablony szybkiego startu wdrażają ten typ zasobu.

Szablon Opis
GitLab Omnibus

Wdróż na platformie Azure
Ten szablon upraszcza wdrażanie narzędzia GitLab Omnibus na maszynie wirtualnej z publicznym systemem DNS, wykorzystując system DNS publicznego adresu IP. Wykorzystuje on rozmiar wystąpienia Standard_F8s_v2, który jest zgodny z architekturą referencyjną i obsługuje maksymalnie 1000 użytkowników (20 RPS). Wystąpienie jest wstępnie skonfigurowane do używania protokołu HTTPS z certyfikatem Let's Encrypt na potrzeby bezpiecznych połączeń.
subskrypcja programu SharePoint / 2019 / 2016 w pełni skonfigurowane

Wdróż na platformie Azure
Utwórz kontroler domeny, farmę programu SQL Server 2022 i od 1 do 5 serwerów hostująca subskrypcję programu SharePoint / 2019 / 2016 z rozbudowaną konfiguracją, w tym zaufane uwierzytelnianie, profile użytkowników z witrynami osobistymi, zaufanie OAuth (przy użyciu certyfikatu), dedykowaną witrynę usług IIS do hostowania dodatków o wysokim zaufaniu itp. Zainstalowano najnowszą wersję oprogramowania kluczy (w tym programu Fiddler, vscode, np++, 7zip, ULS Viewer). Maszyny programu SharePoint mają dodatkowe dostrajanie, aby były natychmiast użyteczne (narzędzia administracji zdalnej, niestandardowe zasady dla przeglądarki Edge i Chrome, skróty itp.).

Definicja zasobu narzędzia Terraform (dostawcy AzAPI)

Typ zasobu virtualMachines/runCommands można wdrożyć przy użyciu operacji docelowych:

  • Grupa zasobów:

Aby uzyskać listę zmienionych właściwości w każdej wersji interfejsu API, zobacz dziennika zmian.

Format zasobu

Aby utworzyć zasób Microsoft.Compute/virtualMachines/runCommands, dodaj następujący program Terraform do szablonu.

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
    }
  })
}

Wartości właściwości

Microsoft.Compute/virtualMachines/runCommands

Nazwa Opis Wartość
lokalizacja Lokalizacja zasobu ciąg (wymagany)
nazwa Nazwa zasobu ciąg (wymagany)
parent_id Identyfikator zasobu, który jest elementem nadrzędnym dla tego zasobu. Identyfikator zasobu typu: virtualMachines
Właściwości Opisuje właściwości polecenia uruchamiania maszyny wirtualnej. VirtualMachineRunCommandProperties
Tagi Tagi zasobów Słownik nazw tagów i wartości.
typ Typ zasobu "Microsoft.Compute/virtualMachines/runCommands@2022-03-01"

Tagi zasobów

Nazwa Opis Wartość

RunCommandInputParameter

Nazwa Opis Wartość
nazwa Nazwa parametru polecenia uruchamiania. ciąg (wymagany)
wartość Wartość parametru polecenia uruchomienia. ciąg (wymagany)

VirtualMachineRunCommandProperties

Nazwa Opis Wartość
asyncExecution Fakultatywny. Jeśli ustawiono wartość true, aprowizacja zostanie ukończona natychmiast po uruchomieniu skryptu i nie będzie czekać na ukończenie skryptu. Bool
errorBlobUri Określa obiekt blob usługi Azure Storage, w którym zostanie przekazany strumień błędów skryptu. struna
outputBlobUri Określa obiekt blob usługi Azure Storage, w którym zostanie przekazany strumień wyjściowy skryptu. struna
Parametry Parametry używane przez skrypt. RunCommandInputParameter[]
protectedParameters Parametry używane przez skrypt. RunCommandInputParameter[]
runAsPassword Określa hasło konta użytkownika na maszynie wirtualnej podczas wykonywania polecenia uruchamiania. struna
runAsUser Określa konto użytkownika na maszynie wirtualnej podczas wykonywania polecenia uruchamiania. struna
źródło Źródło skryptu polecenia uruchamiania. VirtualMachineRunCommandScriptSource
timeoutInSeconds Limit czasu w sekundach do wykonania polecenia uruchomienia. Int

VirtualMachineRunCommandScriptSource

Nazwa Opis Wartość
commandId Określa identyfikator polecenia wstępnie zdefiniowanego wbudowanego skryptu. struna
skrypt Określa zawartość skryptu do wykonania na maszynie wirtualnej. struna
scriptUri Określa lokalizację pobierania skryptu. struna