Выполните команду на серверах с поддержкой Azure Arc (предварительная версия)

В следующих примерах модуль Az.ConnectedMachine для Azure PowerShell используется для выполнения скриптов или команд на сервере с поддержкой Arc.

Выполнение скрипта на компьютере

Эта команда отправляет скрипт на компьютер, запускает его и возвращает захваченные выходные данные.

New-AzConnectedMachineRunCommand -ResourceGroupName "myRG" -MachineName "myMachine" -Location "eastus" -RunCommandName "RunCommandName" –SourceScript "echo Hello World!"

Выполнение скрипта на компьютере с помощью файла скрипта в хранилище

Эта команда направляет агент подключенного компьютера к URI общего доступа с подписью (SAS) для объекта хранилища, в который был загружен скрипт. Затем он направляет агент для выполнения скрипта и возврата захваченных выходных данных.

New-AzConnectedMachineRunCommand -ResourceGroupName "MyRG0" -MachineName "MyMachine" -RunCommandName "MyRunCommand" -Location "eastus" -SourceScriptUri “< SAS URI of a storage blob with read access or public URI>”

Перечисление всех развернутых ресурсов команды Run на компьютере

Эта команда возвращает полный список ранее развернутых команд выполнения вместе со своими свойствами.

Get-AzConnectedMachineRunCommand -ResourceGroupName "myRG" -MachineName "myMachine"

Получение состояния выполнения и результатов

Эта команда извлекает текущий ход выполнения для команды Run, включая последние выходные данные, время начала и окончания, код выхода и состояние терминала выполнения.

Get-AzConnectedMachineRunCommand -ResourceGroupName "myRG" -MachineName "myMachine" -RunCommandName "RunCommandName"

Получение сведений о состоянии команды Run через Просмотр экземпляра

Эта команда получает сведения о состоянии команды 'Run' на компьютере с видом экземпляра. Представление экземпляра содержит состояние выполнения команды Run (успешно, неудачно и т. д.), код выхода, стандартный вывод и стандартные ошибки, созданные при выполнении скрипта. Код выхода, отличный от нуля, указывает на неудачное выполнение.

Get-AzConnectedMachineRunCommand -ResourceGroupName "MyRG" -MachineName "MyMachine" -RunCommandName "MyRunCommand"

Наряду с другими сведениями ответ возвращает следующие поля:

• InstanceViewExecutionState: указывает, был ли ваш скрипт успешным или нет.
• ProvisioningState: указывает, удалось ли платформе расширений активировать скрипт команды Run или нет.

Создание или обновление команды запуска на компьютере

Эта команда создает или обновляет команду Run на компьютере и передает стандартные выходные и стандартные сообщения об ошибках для вывода и ошибки AppendBlobs.

New-AzConnectedMachineRunCommand -ResourceGroupName "MyRG0" -MachineName "MyMachine" -RunCommandName "MyRunCommand3" -Location "eastus" -SourceScript "id; echo HelloWorld" -OutputBlobUri <OutPutBlobUrI> -ErrorBlobUri <ErrorBlobUri>

Создание или обновление команды запуска на компьютере в качестве другого пользователя

Эта команда создает или обновляет команду выполнения на компьютере от имени другого пользователя, используя параметры RunAsUser и RunAsPassword.

Перед использованием этой команды:

• Обратитесь к администратору компьютера и убедитесь, что пользователь имеет доступ к компьютеру.
• Убедитесь, что пользователь имеет доступ к ресурсам, к которым обращается команда Run, например каталоги, файлы и сетевые ресурсы.
• На компьютере с Windows удостоверьтесь, что запущен служба 'Secondary Logon'.

New-AzConnectedMachineRunCommand -ResourceGroupName "MyRG0" -MachineName "MyMachine" -RunCommandName "MyRunCommand" -Location "eastus" -SourceScript "id; echo HelloWorld" -RunAsUser myusername -RunAsPassword mypassword

Создание или обновление команды run на компьютере с помощью локального файла скрипта

Эта команда создает или обновляет команду run на компьютере с помощью локального файла скрипта на клиентском компьютере, где cmdlet выполняется.

New-AzConnectedMachineRunCommand -ResourceGroupName "MyRG0" -MachineName "MyMachine" -RunCommandName "MyRunCommand" -Location "eastus" -ScriptLocalPath "C:\MyScriptsDir\MyScript.ps1"

Создание или обновление команды Run на компьютере при передаче конфиденциальных входных данных в скрипт

Эта команда создает или обновляет команду Run с указанным ProtectedParameter для передачи конфиденциальных входных данных в скрипт, например, паролей или ключей.

$privateParametersArray = @{name='inputText';value='privateParam1value'}

New-AzConnectedMachineRunCommand -MachineName "MyMachine" -ResourceGroupName "MyRG0" -RunCommandName "MyRunCommand" -Location "eastus" -SourceScriptUri <SourceScriptUri> -ProtectedParameter $privateParametersArray 

Пример скрипта для получения inputText:

param ([string]$inputText)
Write-Output $inputText

Вы также можете передавать общедоступные параметры аналогичным образом с помощью Parameter.

• Для Windows: параметр и ProtectedParameter передаются в скрипт, аналогичный следующему примеру: myscript.ps1 -publicParam1 publicParam1value -publicParam2 publicParam2value -secret1 secret1value -secret2 secret2value

• Для Linux: именованный Parameter и его значения задаются в конфигурации среды, которая должна быть доступна в скрипте PowerShell. Для безымянных аргументов передайте пустую строку в поле имени. Безымянные аргументы передаются в скрипт, подобный следующему примеру: myscript.sh publicParam1value publicParam2value secret1value secret2value

Удаление ресурса команды Run с компьютера

Эта команда удаляет ранее развернутый на компьютере ресурс команды Run. Если скрипт все еще выполняется, выполнение прерывается.

Remove-AzConnectedMachineRunCommand -ResourceGroupName "myRG" -MachineName "myMachine" -RunCommandName "RunCommandName"

В следующих примерах используется az connectedmachine run-command для запуска shell-скрипта на сервере с поддержкой Arc.

Выполнение скрипта на компьютере

Эта команда отправляет скрипт на компьютер, запускает его и возвращает захваченные выходные данные.

az connectedmachine run-command create --name "myRunCommand" --machine-name "myMachine" --resource-group "myRG" --script "Write-Host Hello World!"

Перечисление всех развернутых ресурсов команды Run на компьютере

Эта команда возвращает полный список ранее развернутых команд Run вместе со своими свойствами.

az connectedmachine run-command list --machine-name "myMachine" --resource-group "myRG"

Получение состояния выполнения и результатов

Эта команда извлекает текущий ход выполнения для команды Run, включая последние выходные данные, время начала и окончания, код выхода и состояние терминала выполнения.

az connectedmachine run-command show --name "myRunCommand" --machine-name "myMachine" --resource-group "myRG"

Удаление ресурса команды Run с компьютера

Эта команда удаляет ранее развернутый на компьютере ресурс команды Run. Если скрипт всё ещё выполняется, выполнение прекращается.

az connectedmachine run-command delete --name "myRunCommand" --machine-name "myMachine" --resource-group "myRG"

В примерах команд в этом разделе показано, как использовать REST API для удаленной настройки правила брандмауэра, разрешающего доступ к конечной точке www.microsoft.com/pkiops/certs. В примере сценария используются все доступные операции REST и следующие значения:

• Идентификатор подписки - aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e
• Имя сервера с поддержкой Arc - 2012DatacenterServer1
• Группа ресурсов - ContosoRG
• Операционная система сервера — серверы Windows Server 2012 / R2

Создание доступа к конечной точке с помощью команды запуска

Сначала создайте скрипт команды Run, чтобы предоставить доступ к www.microsoft.com/pkiops/certs конечной точке на целевом сервере с поддержкой Arc с помощью операции PUT.

Вы можете либо встроить скрипт непосредственно, либо указать ссылку на файл скрипта.

Чтобы предоставить скрипт в строке, выполните следующие действия.

PUT https://management.azure.com/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/ContosoRG/providers/Microsoft.HybridCompute/machines/2012DatacenterServer1/runCommands/EndpointAccessCommand?api-version=2024-11-10-preview

{
  "location": "eastus2",
  "properties": {
    "source": {
      "script": "New-NetFirewallRule -DisplayName $ruleName -Direction Outbound -Action Allow -RemoteAddress $endpoint -RemotePort $port -Protocol $protocol"
    },
    "parameters": [
      {
        "name": "ruleName",
        "value": "Allow access to www.microsoft.com/pkiops/certs"
      },
      {
        "name": "endpoint",
        "value": "www.microsoft.com/pkiops/certs"
      },
      {
        "name": "port",
      "value": 443
      },
      {
        "name": "protocol",
        "value": "TCP"
      }
    ],
    "asyncExecution": false,
    "runAsUser": "contoso-user1",
    "runAsPassword": "Contoso123!",
    "timeoutInSeconds": 3600,
    "outputBlobUri": "https://mystorageaccount.blob.core.windows.net/myscriptoutputcontainer/MyScriptoutput.txt",
    "errorBlobUri": "https://mystorageaccount.blob.core.windows.net/mycontainer/MyScriptError.txt"
  }
}

Чтобы связаться с файлом скрипта, выполните следующие действия.

PUT https://management.azure.com/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/ContosoRG/providers/Microsoft.HybridCompute/machines/2012DatacenterServer1/runCommands/EndpointAccessCommand?api-version=2024-11-10-preview

{
  "location": "eastus2",
  "properties": {
    "source": {
      "scriptUri": "https://mystorageaccount.blob.core.windows.net/myscriptoutputcontainer/newnetfirewallrule.ps1"
    },
    "parameters": [
      {
        "name": "ruleName",
        "value": " Allow access to www.microsoft.com/pkiops/certs"
      },
      {
        "name": "endpoint",
        "value": "www.microsoft.com/pkiops/certs"
      },
      {
        "name": "port",
        "value": 443
      },
      {
        "name": "protocol",
        "value": "TCP"
      }
    ],
    "asyncExecution": false,
    "runAsUser": "contoso-user1",
    "runAsPassword": "Contoso123!",
    "timeoutInSeconds": 3600,
    "outputBlobUri": "https://mystorageaccount.blob.core.windows.net/myscriptoutputcontainer/MyScriptoutput.txt",
    "errorBlobUri": "https://mystorageaccount.blob.core.windows.net/mycontainer/MyScriptError.txt"
  }
}

Это scriptUri унифицированный указатель ресурса (URI) подписанного URL-адреса с общим доступом (SAS) для объекта BLOB хранилища, и он должен предоставлять доступ для чтения к этому объекту. Для URI SAS предлагается срок действия 24 часа. Вы можете создать URI SAS на портале Azure с помощью параметров блобов или маркера New-AzStorageBlobSASToken SAS. Если вы создаете маркер SAS с помощью New-AzStorageBlobSASToken, формат URI SAS: base blob URL + "?" + маркер SAS из New-AzStorageBlobSASToken.

Вывод и ошибки должны быть двоичными блобами типа AppendBlob, а их SAS URI должны обеспечивать доступ на чтение, добавление, создание и запись. Для URI SAS предлагается срок действия 24 часа. Вы можете создавать URI SAS на портале Azure с помощью параметров объекта BLOB или маркера SAS, используя New-AzStorageBlobSASToken.

Дополнительные сведения о подписанных URL-адресах см. в статье Предоставление ограниченного доступа к ресурсам службы хранилища Azure с помощью подписанных URL-адресов (SAS).

Проверка сведений о команде run

Убедитесь, что вы правильно подготовили команду Run с помощью операции GET:

GET https://management.azure.com/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/ContosoRG/providers/Microsoft.HybridCompute/machines/2012DatacenterServer1/runCommands/EndpointAccessCommand?api-version=2024-11-10-preview

Обновление команды Run

Вы можете обновить существующую команду run с новыми параметрами с помощью операции PATCH. В следующем примере добавляется доступ к другой конечной точке *.waconazure.comдля подключения к Windows Admin Center.

PATCH https://management.azure.com/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/ContosoRG/providers/Microsoft.HybridCompute/machines/2012DatacenterServer1/runCommands/EndpointAccessCommand?api-version=2024-11-10-preview

{
  "location": "eastus2",
  "properties": {
    "source": {
      "script": "New-NetFirewallRule -DisplayName $ruleName -Direction Outbound -Action Allow -RemoteAddress $endpoint -RemotePort $port -Protocol $protocol"
    },
    "parameters": [
      {
        "name": "ruleName",
        "value": "Allow access to WAC endpoint"
      },
      {
        "name": "endpoint",
        "value": "*.waconazure.com"
      },
      {
        "name": "port",
        "value": 443
      },
      {
        "name": "protocol",
        "value": "TCP"
      }
    ],
    "asyncExecution": false,
    "runAsUser": "contoso-user1",
    "runAsPassword": "Contoso123!",
    "timeoutInSeconds": 3600,
    "outputBlobUri": "https://mystorageaccount.blob.core.windows.net/myscriptoutputcontainer/MyScriptoutput.txt",
    "errorBlobUri": "https://mystorageaccount.blob.core.windows.net/mycontainer/MyScriptError.txt"
  }
}

Список команд выполнить

Перед удалением команды Run для доступа к конечной точке убедитесь, что сервер с поддержкой Arc не имеет других команд Run. Используйте операцию LIST, чтобы получить все команды run на сервере с поддержкой Arc:

LIST https://management.azure.com/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/ContosoRG/providers/Microsoft.HybridCompute/machines/2012DatacenterServer1/runCommands?api-version=2024-11-10-preview

Удаление команды run

Если расширение команды Run больше не требуется, удалите его с помощью следующей операции DELETE:

DELETE https://management.azure.com/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/ContosoRG/providers/Microsoft.HybridCompute/machines/2012DatacenterServer1/runCommands/EndpointAccessCommand?api-version=2024-11-10-preview