Udostępnij za pośrednictwem

Microsoft.Compute virtualMachines/runCommands 2021-04-01

  • Artykuł

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@2021-04-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
  }
}

Wartości właściwości

virtualMachines/runCommands

Nazwa Opis Wartość
nazwa Nazwa zasobu

Zobacz, jak ustawić nazwy i typy dla zasobów podrzędnych w Bicep.		 ciąg (wymagany)
lokalizacja Lokalizacja zasobu ciąg (wymagany)
Tagi Tagi zasobów Słownik nazw tagów i wartości. Zobacz tagi w szablonach
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

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

RunCommandInputParameter

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

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
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.).
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ń.

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": "2021-04-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"
  }
}

Wartości właściwości

virtualMachines/runCommands

Nazwa Opis Wartość
typ Typ zasobu "Microsoft.Compute/virtualMachines/runCommands"
apiVersion Wersja interfejsu API zasobów '2021-04-01'
nazwa Nazwa zasobu

Zobacz, jak ustawiać nazwy i typy dla zasobów podrzędnych w szablonach usługi ARM JSON.		 ciąg (wymagany)
lokalizacja Lokalizacja zasobu ciąg (wymagany)
Tagi Tagi zasobów Słownik nazw tagów i wartości. Zobacz tagi w szablonach
Właściwości Opisuje właściwości polecenia uruchamiania maszyny wirtualnej. VirtualMachineRunCommandProperties

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

RunCommandInputParameter

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

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
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.).
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ń.

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@2021-04-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
    }
  })
}

Wartości właściwości

virtualMachines/runCommands

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

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

RunCommandInputParameter

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

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