Ejecute el comando en servidores habilitados para Azure Arc (versión preliminar)

En los ejemplos siguientes se usa el módulo Az.ConnectedMachine para Azure PowerShell para ejecutar scripts o comandos en un servidor habilitado para Arc.

Ejecución de un script en una máquina

Este comando envía el script a la máquina, lo ejecuta y devuelve la salida capturada.

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

Ejecución de un script en la máquina mediante un archivo de script en el almacenamiento

Este comando dirige el agente de Connected Machine a un URI de firma de acceso compartido (SAS) para un blob de almacenamiento donde se cargó un script. A continuación, dirige al agente para ejecutar el script y devolver la salida capturada.

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

Enumerar todos los recursos de comando Run implementados en una máquina

Este comando devuelve una lista completa de los comandos de ejecución implementados anteriormente junto con sus propiedades.

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

Obtención del estado de ejecución y los resultados

Este comando recupera el progreso de ejecución actual de un comando Ejecutar, incluida la salida más reciente, la hora de inicio y finalización, el código de salida y el estado terminal de la ejecución.

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

Obtención de información de estado de un comando Run a través de la vista de instancia

Este comando obtiene información de estado para un comando de ejecución en una máquina con vista de instancia. La vista de instancia contiene el estado de ejecución del comando Ejecutar (correcto, erróneo, etc.), código de salida, salida estándar y error estándar generado mediante la ejecución del script. Un código de salida distinto de cero indica una ejecución incorrecta.

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

Junto con otra información, la respuesta devuelve estos campos:

• InstanceViewExecutionState: indica si el script se realizó correctamente o no.
• ProvisioningState: indica si la plataforma de extensión pudo desencadenar o no el script del comando Run.

Creación o actualización del comando Ejecutar en una máquina

Este comando crea o actualiza un comando Run en una máquina y transmite la salida estándar y los mensajes de error estándar a AppendBlobs de salida y error.

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

Cree o actualice Ejecutar comando en un equipo como un usuario diferente

Este comando crea o actualiza un comando de ejecución en una máquina como un usuario diferente mediante los parámetros RunAsUser y RunAsPassword.

Antes de usar este comando:

• Póngase en contacto con el administrador del equipo y asegúrese de que el usuario tiene acceso a la máquina.
• Asegúrese de que el usuario tiene acceso a los recursos a los que accede el comando Ejecutar, como directorios, archivos y recursos de red.
• En un equipo Windows, asegúrese de que se está ejecutando "Inicio de sesión secundario".

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

Creación o actualización del comando Run en un equipo con un archivo de script local

Este comando crea o actualiza un comando de ejecución en un equipo utilizando un archivo de script local en el equipo cliente donde cmdlet se ejecuta.

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

Cree o actualice Ejecutar comando en una máquina mientras se pasan entradas confidenciales al script

Este comando crea o actualiza el comando Ejecutar con ProtectedParameter especificado para pasar entradas confidenciales a un script, como contraseñas o claves.

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

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

Script de ejemplo para capturar texto de entrada.

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

También puede pasar parámetros públicos de forma similar mediante Parameter.

• Para Windows: Parameter y ProtectedParameter se pasan a un script similar al ejemplo siguiente: myscript.ps1 -publicParam1 publicParam1value -publicParam2 publicParam2value -secret1 secret1value -secret2 secret2value

• Para Linux: un nombre Parameter y sus valores se establecen en la configuración del entorno, que debe ser accesible dentro del script de PowerShell. Para los argumentos sin nombre, pase una cadena vacía a la entrada de nombre. Los argumentos sin nombre se pasan al script similar al ejemplo siguiente: myscript.sh publicParam1value publicParam2value secret1value secret2value

Eliminar el recurso de comando Ejecutar de la máquina

Este comando quita el recurso del comando 'Run' previamente desplegado en la máquina. Si la ejecución del script todavía está en curso, la ejecución finaliza.

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

En los ejemplos siguientes se usa az connectedmachine run-command para ejecutar un script de shell en un servidor habilitado para Arc.

Ejecución de un script en una máquina

Este comando envía el script a la máquina, lo ejecuta y devuelve la salida capturada.

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

Enumerar todos los recursos de comando Run implementados en una máquina

Este comando devuelve una lista completa de los comandos Run implementados anteriormente junto con sus propiedades.

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

Obtención del estado de ejecución y los resultados

Este comando recupera el progreso de ejecución actual de un comando Ejecutar, incluida la salida más reciente, la hora de inicio y finalización, el código de salida y el estado terminal de la ejecución.

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

Eliminar el recurso del comando Ejecutar de una máquina

Este comando elimina el recurso del comando Ejecutar que fue implementado previamente en la máquina. Si la ejecución del script sigue en curso, se interrumpe.

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

Los comandos de ejemplo de esta sección muestran cómo usar la API REST para configurar de forma remota una regla de firewall que permita el acceso al punto de conexión www.microsoft.com/pkiops/certs. En el escenario de ejemplo se usa cada una de las operaciones REST disponibles y los siguientes valores:

• Identificador de suscripción - aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e
• Nombre del servidor habilitado para Arc - 2012DatacenterServer1
• Grupo de recursos - ContosoRG
• Sistema operativo del servidor : servidores de Windows Server 2012/R2

Creación de acceso al punto de conexión con un comando de ejecución

En primer lugar, cree un script de comando de ejecución para proporcionar acceso al punto de conexión en el servidor de destino habilitado con Arc www.microsoft.com/pkiops/certs mediante la operación PUT.

Puede proporcionar el guion en línea o puede vincularlo al archivo de guion.

Para proporcionar el script en línea:

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

Para vincular al archivo de script:

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 es un URI de firma de acceso compartido (SAS) para el blob de almacenamiento y debe proporcionar acceso de lectura al blob. Se recomienda un tiempo de expiración de 24 horas para el URI de SAS. Puede generar un URI de SAS en Azure Portal mediante opciones de blobs o token de SAS mediante New-AzStorageBlobSASToken. Si genera el token de SAS mediante New-AzStorageBlobSASToken, el formato de URI de SAS es: base blob URL + "?" + el token de SAS de New-AzStorageBlobSASToken.

Los blobs de salida y error deben ser el tipo AppendBlob y sus URI de SAS deben proporcionar acceso de lectura, anexión, creación y escritura al blob. Se recomienda un tiempo de expiración de 24 horas para el URI de SAS. Puede generar URI de SAS en Azure Portal mediante las opciones del blob o el token de SAS mediante New-AzStorageBlobSASToken.

Para más información sobre las firmas de acceso compartido, consulte Concesión de acceso limitado a recursos de Azure Storage mediante firmas de acceso compartido (SAS).

Verificar los detalles del comando de ejecución

Compruebe que ha aprovisionado correctamente el comando Ejecutar mediante la operación 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

Actualizar el comando Ejecutar

Puede actualizar el comando Run existente con nuevos parámetros mediante la operación PATCH. En el ejemplo siguiente se agrega acceso a otro punto de conexión, *.waconazure.com, para la conectividad a 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"
  }
}

Listar comandos Run

Antes de eliminar el comando Ejecutar para el acceso al punto de conexión, asegúrese de que el servidor habilitado para Arc no tenga ningún otro comando Ejecutar. Usa la operación LIST para obtener todos los comandos de ejecución en el servidor habilitado para 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

Eliminar el comando Ejecutar

Cuando ya no necesite la extensión Ejecutar comando, elimínela mediante la siguiente operación 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