Opdracht uitvoeren op servers met Azure Arc (preview)

In de volgende voorbeelden wordt de Az.ConnectedMachine-module voor Azure PowerShell gebruikt om scripts of opdrachten uit te voeren op een server met Arc.

Een script uitvoeren op een computer

Met deze opdracht wordt het script naar de computer verzonden, uitgevoerd en wordt de vastgelegde uitvoer geretourneerd.

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

Een script uitvoeren op de computer met behulp van een scriptbestand in de opslag

Met deze opdracht wordt de Connected Machine-agent omgeschakeld naar een SAS-URI (Shared Access Signature) voor een opslagblob waarop een script is geüpload. Vervolgens wordt de agent opgedragen om het script uit te voeren en de vastgelegde uitvoer terug te sturen.

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

Een lijst weergeven van alle geïmplementeerde run-opdrachtbronnen op een computer

Met deze opdracht wordt een volledige lijst met eerder geïmplementeerde run-opdrachten geretourneerd, samen met de bijbehorende eigenschappen.

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

Uitvoeringsstatus en -resultaten ophalen

Met deze opdracht wordt de huidige uitvoeringsvoortgang opgehaald voor een opdracht Uitvoeren, inclusief de meest recente uitvoer, begin- en eindtijd, afsluitcode en terminalstatus van de uitvoering.

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

Statusinformatie ophalen voor een uitvoeropdracht door middel van de exemplaarweergave

Met deze opdracht wordt statusinformatie opgehaald voor een Run-opdracht op een machine met een exemplaarweergave. De exemplaarweergave bevat de uitvoeringsstatus van de opdracht Uitvoeren (geslaagd, mislukt, enzovoort), afsluitcode, standaarduitvoer en standaardfout die wordt gegenereerd door het uitvoeren van het script. een afsluitcode die niet nul is, duidt op een mislukte uitvoering.

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

Samen met andere informatie retourneert het antwoord deze velden:

• InstanceViewExecutionState: Geeft aan of uw script al dan niet is geslaagd.
• ProvisioningState: Geeft aan of het extensieplatform het opdrachtscript Uitvoeren kan activeren of niet.

Run Command maken of bijwerken op een machine

Met deze opdracht maakt of werkt u een Uitvoeren-opdracht op een computer bij en streamt de standaarduitvoer en standaardfoutberichten naar uitvoer- en fout-AppendBlobs.

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

Run-opdracht op een computer maken of bijwerken als een andere gebruiker

Met deze opdracht wordt een Run-opdracht op een computer aangemaakt of bijgewerkt als gebruiker met een andere identiteit, met behulp van de RunAsUser en RunAsPassword parameters.

Voordat u deze opdracht gebruikt:

• Neem contact op met de beheerder van de computer en zorg ervoor dat de gebruiker toegang heeft tot de computer.
• Zorg ervoor dat de gebruiker toegang heeft tot de resources die worden geopend met de opdracht Uitvoeren, zoals mappen, bestanden en netwerkbronnen.
• Zorg ervoor dat 'Secundaire aanmelding' wordt uitgevoerd op een Windows-computer.

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

Run-opdracht maken of bijwerken op een apparaat met een lokaal scriptbestand

Met deze opdracht wordt een "Run"-opdracht op een computer gecreëerd of bijgewerkt door middel van een lokaal scriptbestand op de clientcomputer waarop het cmdlet wordt uitgevoerd.

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

Een Uitvoeren-opdracht maken of bijwerken op een machine terwijl gevoelige invoer aan het script wordt doorgegeven

Met deze opdracht maakt of werkt u de Run-opdracht bij zoals opgegeven door ProtectedParameter om gevoelige invoer door te geven aan een script, zoals wachtwoorden of sleutels.

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

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

Voorbeeldscript voor het vastleggen van inputText:

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

U kunt ook openbare parameters op een vergelijkbare manier doorgeven met behulp van Parameter.

• Voor Windows: Parameter en ProtectedParameter worden doorgegeven aan een script dat vergelijkbaar is met het volgende voorbeeld: myscript.ps1 -publicParam1 publicParam1value -publicParam2 publicParam2value -secret1 secret1value -secret2 secret2value

• Voor Linux: Een benoemde Parameter en de bijbehorende waarden worden ingesteld op de omgevingsconfiguratie, die toegankelijk moet zijn binnen het PowerShell-script. Geef voor naamloze argumenten een lege tekenreeks door om de invoer een naam te geven. Naamloze argumenten worden doorgegeven aan scripts die vergelijkbaar zijn met het volgende voorbeeld: myscript.sh publicParam1value publicParam2value secret1value secret2value

Opdrachtresource Uitvoeren van de machine verwijderen

Met deze opdracht verwijdert u de opdrachtresource Uitvoeren die eerder op de computer is geïmplementeerd. Als de uitvoering van het script nog bezig is, wordt deze beëindigd.

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

In de volgende voorbeelden wordt az connectedmachine run-command gebruikt om een shellscript uit te voeren op een server met Arc-ondersteuning.

Een script uitvoeren op een computer

Met deze opdracht wordt het script naar de computer verzonden, uitgevoerd en wordt de vastgelegde uitvoer geretourneerd.

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

Een lijst weergeven van alle geïmplementeerde run-opdrachtbronnen op een computer

Met deze opdracht wordt een volledige lijst met eerder geïmplementeerde run-opdrachten geretourneerd, samen met de bijbehorende eigenschappen.

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

Uitvoeringsstatus en -resultaten ophalen

Met deze opdracht wordt de huidige uitvoeringsvoortgang opgehaald voor een opdracht Uitvoeren, inclusief de meest recente uitvoer, begin- en eindtijd, afsluitcode en terminalstatus van de uitvoering.

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

De opdrachtresource Uitvoeren van een machine verwijderen

Met deze opdracht verwijdert u de opdrachtresource Uitvoeren die eerder op de computer is geïmplementeerd. Als het script nog steeds wordt uitgevoerd, wordt de uitvoering beëindigd.

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

In de voorbeeldopdrachten in deze sectie ziet u hoe u de REST API kunt gebruiken om een firewallregel op afstand te configureren waarmee toegang tot het eindpunt www.microsoft.com/pkiops/certswordt toegestaan. In het voorbeeldscenario worden alle beschikbare REST-bewerkingen en de volgende waarden gebruikt:

• Abonnements-id - aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e
• Arc-ingeschakelde servernaam - 2012DatacenterServer1
• Resourcegroep - ContosoRG
• Het besturingssysteem van de server - Windows Server 2012 / R2-servers

Eindpunttoegang maken met een opdracht uitvoeren

Maak eerst een uitvoeringsscript om toegang te bieden tot het www.microsoft.com/pkiops/certs eindpunt op uw Arc-ingeschakelde doelserver met behulp van de PUT-bewerking.

U kunt het script inline opgeven of u kunt een koppeling maken naar het scriptbestand.

Het script inline opgeven:

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

Ga als volgende te werk om een koppeling naar het scriptbestand te maken:

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

Het scriptUri is een SAS-URI (Shared Access Signature) voor de opslagblob en moet leestoegang tot de blob bieden. Er wordt een verlooptijd van 24 uur voorgesteld voor de SAS-URI. U kunt een SAS-URI genereren in Azure Portal met behulp van blobs-opties of SAS-token met behulp van New-AzStorageBlobSASToken. Als u een SAS-token genereert met behulp van New-AzStorageBlobSASToken, is de SAS-URI-indeling: base blob URL + "?" + het SAS-token van New-AzStorageBlobSASToken.

Uitvoer- en fout-blobs moeten het type AppendBlob zijn en hun SAS-URI's moeten lees-, toevoeg-, maak- en schrijftoegang bieden tot de blob. Er wordt een verlooptijd van 24 uur voorgesteld voor sas-URI. U kunt SAS-URI's genereren in de Azure-portal met behulp van de opties van blob of een SAS-token met New-AzStorageBlobSASToken.

Zie Beperkte toegang verlenen tot Azure Storage-resources met behulp van Sas (Shared Access Signatures) voor meer informatie over handtekeningen voor gedeelde toegang.

Details van de opdracht Uitvoeren controleren

Controleer of u de opdracht Uitvoeren juist hebt ingericht met behulp van de GET-bewerking:

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

De opdracht Uitvoeren bijwerken

U kunt de bestaande opdracht Uitvoeren bijwerken met nieuwe parameters met behulp van de PATCH-bewerking. In het volgende voorbeeld wordt toegang toegevoegd aan een ander eindpunt, *.waconazure.comvoor connectiviteit met Het Windows-beheercentrum.

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

Opdrachten voor uitvoeren weergeven

Voordat u de opdracht Uitvoeren voor eindpunttoegang verwijdert, moet u ervoor zorgen dat de server met Arc geen andere run-opdrachten heeft. Gebruik de LIST-bewerking om alle Run-opdrachten op te halen op de Arc-enabled server.

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

Een Uitvoeren-opdracht verwijderen

Wanneer u de opdrachtextensie Uitvoeren niet meer nodig hebt, verwijdert u deze met behulp van de volgende DELETE-bewerking:

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