Set-AzVmssVMRunCommand

Referentie

Module:: Az.Compute

De bewerking voor het maken of bijwerken van de opdracht voor het uitvoeren van de VMSS-VM.

Syntaxis

Set-AzVmssVMRunCommand
   -InstanceId <String>
   -ResourceGroupName <String>
   -RunCommandName <String>
   -VMScaleSetName <String>
   [-SubscriptionId <String>]
   -Location <String>
   [-AsyncExecution]
   [-ErrorBlobManagedIdentityClientId <String>]
   [-ErrorBlobManagedIdentityObjectId <String>]
   [-ErrorBlobUri <String>]
   [-OutputBlobManagedIdentityClientId <String>]
   [-OutputBlobManagedIdentityObjectId <String>]
   [-OutputBlobUri <String>]
   [-Parameter <IRunCommandInputParameter[]>]
   [-ProtectedParameter <IRunCommandInputParameter[]>]
   [-RunAsPassword <String>]
   [-RunAsUser <String>]
   [-ScriptUriManagedIdentityClientId <String>]
   [-ScriptUriManagedIdentityObjectId <String>]
   [-SourceCommandId <String>]
   [-SourceScript <String>]
   [-SourceScriptUri <String>]
   [-Tag <Hashtable>]
   [-TimeoutInSecond <Int32>]
   [-TreatFailureAsDeploymentFailure]
   [-DefaultProfile <PSObject>]
   [-AsJob]
   [-NoWait]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-AzVmssVMRunCommand
   -InstanceId <String>
   -ResourceGroupName <String>
   -RunCommandName <String>
   -VMScaleSetName <String>
   [-SubscriptionId <String>]
   -Location <String>
   [-AsyncExecution]
   [-ErrorBlobManagedIdentityClientId <String>]
   [-ErrorBlobManagedIdentityObjectId <String>]
   [-ErrorBlobUri <String>]
   [-OutputBlobManagedIdentityClientId <String>]
   [-OutputBlobManagedIdentityObjectId <String>]
   [-OutputBlobUri <String>]
   [-Parameter <IRunCommandInputParameter[]>]
   [-ProtectedParameter <IRunCommandInputParameter[]>]
   [-RunAsPassword <String>]
   [-RunAsUser <String>]
   [-ScriptUriManagedIdentityClientId <String>]
   [-ScriptUriManagedIdentityObjectId <String>]
   [-Tag <Hashtable>]
   [-TimeoutInSecond <Int32>]
   [-TreatFailureAsDeploymentFailure]
   -ScriptLocalPath <String>
   [-DefaultProfile <PSObject>]
   [-AsJob]
   [-NoWait]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

De bewerking voor het maken of bijwerken van de opdracht voor het uitvoeren van de VMSS-VM.

Voorbeelden

Voorbeeld 1: Opdracht Uitvoeren maken of bijwerken op een VMSS VM-exemplaar met behulp van een SAS-URL voor opslagblob

Set-AzVmssVMRunCommand -ResourceGroupName MyRG0 -VMScaleSetName MyVMSS -InstanceId 0 -RunCommandName MyRunCommand -Location EastUS2EUAP -SourceScriptUri "https://myst.blob.core.windows.net/mycontainer/myscript.ps1?sp=r&st=2022-10-27T21:02:35Z&se=2022-10-28T05:02:35Z&spr=https&sv=2021-06-08&sr=b&sig=0I%2FIiYayRwHasfasasfdasdfasdeTsQjLnpZjA%3D"

Location      Name          Type
--------      ----          ----
eastus2euap   MyRunCommand  Microsoft.Compute/virtualMachines/runCommands

Maak of werk de opdracht Uitvoeren bij op een Exemplaar van een Windows VMSS-VM met behulp van een SAS-URL van een opslagblob die .ps1 script bevat. Opmerking SAS-URL moet leestoegang bieden tot de blob. Er wordt een verlooptijd van 24 uur voorgesteld voor de SAS-URL. SAS-URL's kunnen worden gegenereerd in Azure Portal met behulp van de opties van blob of SAS-token met new-AzStorageBlobSASToken. Als u een SAS-token genereert met behulp van New-AzStorageBlobSASToken, is uw SAS-URL = basis-blob-URL + "?" + SAS-token van New-AzStorageBlobSASToken.

Voorbeeld 2: Voeropdracht maken of bijwerken op een VMSS-VM-exemplaar met behulp van een lokaal scriptbestand.

Set-AzVmssVMRunCommand -ResourceGroupName MyRG0 -VMScaleSetName MyVMSS -InstanceId 0 -RunCommandName MyRunCommand -Location EastUS2EUAP -ScriptLocalPath "C:\MyScriptsDir\MyScript.ps1"

Location      Name          Type
--------      ----          ----
eastus2euap   MyRunCommand  Microsoft.Compute/virtualMachines/runCommands

Maak of werk de opdracht Uitvoeren bij op een VMSS-VM-exemplaar met behulp van een lokaal scriptbestand dat zich op de clientcomputer bevindt waarop de cmdlet wordt uitgevoerd.

Voorbeeld 3: Voeropdracht maken of bijwerken op een VMSS VM-exemplaar met behulp van scripttekst.

Set-AzVmssVMRunCommand -ResourceGroupName MyRG0 -VMScaleSetName MyVMSSL -InstanceId 1 -RunCommandName MyRunCommand2 -Location EastUS2EUAP -SourceScript "id; echo HelloWorld"

Location      Name           Type
--------      ----           ----
eastus2euap   MyRunCommand2  Microsoft.Compute/virtualMachines/runCommands

Maak of werk de opdracht Uitvoeren bij op een VMSS-VM-exemplaar dat de scriptinhoud rechtstreeks doorgeeft aan -SourceScript parameter. Gebruik ';' om meerdere opdrachten te scheiden.

Voorbeeld 4: Voeropdracht maken of bijwerken op een VMSS VM-exemplaar met behulp van commandId.

Set-AzVmssVMRunCommand -ResourceGroupName MyRG0 -VMScaleSetName MyVMSS -InstanceId 0 -RunCommandName MyRunCommand -Location EastUS2EUAP -SourceCommandId DisableWindowsUpdate

Location      Name          Type
--------      ----          ----
eastus2euap   MyRunCommand  Microsoft.Compute/virtualMachines/runCommands

Maak of werk de opdracht Uitvoeren bij op een VMSS VM-exemplaar met behulp van een bestaande commandId. Beschikbare commandIds kunnen worden opgehaald met Get-AzVMRunCommandDocument.

Voorbeeld 5: Voeropdracht maken of bijwerken op een VMSS VM-exemplaar en standaarduitvoer en standaardfoutberichten streamen naar uitvoer en fout Toevoeg-blobs.

Set-AzVmssVMRunCommand -ResourceGroupName MyRG0 -VMScaleSetName MyVMSS -InstanceId 1 -RunCommandName MyRunCommand3 -Location EastUS2EUAP -ScriptLocalPath "C:\MyScriptsDir\MyScript.ps1" -OutputBlobUri "https://vivst.blob.core.windows.net/vivcontainer/output.txt?sp=racw&st=2022-10-27T22:18:36Z&se=2022-10-28T06:18:36Z&spr=https&sv=2021-06-08&sr=b&sig=HQAu3Bl%2BKMofYTjMo8o5hasfadsfasdF4jIkRJra4S5FlEo%3D" -ErrorBlobUri "https://vivst.blob.core.windows.net/vivcontainer/error.txt?sp=racw&st=2022-10-27T22:18:36Z&se=2022-10-28T06:18:36Z&spr=https&sv=2021-06-08&sr=b&sig=HQAu3Bl%2BKMofYTjMo8o5h%asfasdfgdT%2F4jasfasdf5FlEo%3D"

Location      Name           Type
--------      ----           ----
eastus2euap   MyRunCommand3  Microsoft.Compute/virtualMachines/runCommands

Maak of werk de opdracht Uitvoeren bij op een VMSS VM-exemplaar en stream standaarduitvoer en standaardfoutberichten naar uitvoer en fout Toevoeg-blobs. Opmerking-uitvoer en fout-blobs moeten van het type AppendBlob zijn en hun SAS-URL's moeten lees-, toevoeg-, create-, schrijftoegang tot de blob bieden. Er wordt een verlooptijd van 24 uur voorgesteld voor de SAS-URL. Als de uitvoer- of foutblob niet bestaat, wordt er een blob van het type AppendBlob gemaakt. SAS-URL's kunnen worden gegenereerd in Azure Portal met behulp van de opties van blob of SAS-token met new-AzStorageBlobSASToken. Als u een SAS-token genereert met behulp van New-AzStorageBlobSASToken, is uw SAS-URL = basis-blob-URL + "?" + SAS-token van New-AzStorageBlobSASToken.

Voorbeeld 6: Voer de opdracht Uitvoeren op een VMSS-VM-exemplaar te maken of bij te werken, voer de opdracht uitvoeren als een andere gebruiker uit met de parameters RunAsUser en RunAsPassword.

Set-AzVmssVMRunCommand -ResourceGroupName MyRG0 -VMScaleSetName MyVMSS -InstanceId 1 -RunCommandName MyRunCommand -Location EastUS2EUAP -ScriptLocalPath "C:\MyScriptsDir\MyScript.ps1" -RunAsUser myusername -RunAsPassword mypassword

Location      Name          Type
--------      ----          ----
eastus2euap   MyRunCommand  Microsoft.Compute/virtualMachines/runCommands

Maak of werk de opdracht Uitvoeren bij op een VMSS VM-exemplaar en voer de opdracht Uitvoeren uit als een andere gebruiker met behulp van RunAsUser- en RunAsPassword-parameters. Neem contact op met de beheerder van de VM en zorg ervoor dat de gebruiker op de VM wordt toegevoegd, heeft de gebruiker toegang tot resources die toegankelijk zijn via de opdracht Uitvoeren (mappen, bestanden, netwerk, enzovoort) en in het geval van windows-VM wordt de secundaire aanmeldingsservice op de VM uitgevoerd.

Parameters

-AsJob

De opdracht uitvoeren als een taak

Type:	SwitchParameter
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-AsyncExecution

Facultatief. Als dit is ingesteld op true, wordt het inrichten voltooid zodra het script wordt gestart en wacht niet totdat het script is voltooid.

Type:	SwitchParameter
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-Confirm

U wordt gevraagd om bevestiging voordat u de cmdlet uitvoert.

Type:	SwitchParameter
Aliassen:	cf
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-DefaultProfile

De parameter DefaultProfile is niet functioneel. Gebruik de parameter SubscriptionId indien beschikbaar als u de cmdlet uitvoert voor een ander abonnement.

Type:	PSObject
Aliassen:	AzureRMContext, AzureCredential
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-ErrorBlobManagedIdentityClientId

Client-id (GUID-waarde) van de door de gebruiker toegewezen beheerde identiteit. ObjectId mag niet worden gebruikt als dit is opgegeven.

Type:	String
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-ErrorBlobManagedIdentityObjectId

Object-id (GUID-waarde) van de door de gebruiker toegewezen beheerde identiteit. ClientId mag niet worden gebruikt als dit is opgegeven.

Type:	String
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-ErrorBlobUri

Hiermee geeft u de Azure Storage-blob op waar de scriptfoutstroom wordt geüpload. Gebruik een SAS-URI met lees-, toevoeg-, maak-, schrijftoegang OF gebruik beheerde identiteit om de VM-toegang tot de blob te bieden. Refer errorBlobManagedIdentity parameter.

Type:	String
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-InstanceId

De exemplaar-id van de virtuele machine.

Type:	String
Position:	Named
Default value:	None
Vereist:	True
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-Location

Resourcelocatie

Type:	String
Position:	Named
Default value:	None
Vereist:	True
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-NoWait

De opdracht asynchroon uitvoeren

Type:	SwitchParameter
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-OutputBlobManagedIdentityClientId

Client-id (GUID-waarde) van de door de gebruiker toegewezen beheerde identiteit. ObjectId mag niet worden gebruikt als dit is opgegeven.

Type:	String
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-OutputBlobManagedIdentityObjectId

Object-id (GUID-waarde) van de door de gebruiker toegewezen beheerde identiteit. ClientId mag niet worden gebruikt als dit is opgegeven.

Type:	String
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-OutputBlobUri

Hiermee geeft u de Azure Storage-blob op waar de scriptuitvoerstroom wordt geüpload. Gebruik een SAS-URI met lees-, toevoeg-, maak-, schrijftoegang OF gebruik beheerde identiteit om de VM-toegang tot de blob te bieden. Refer outputBlobManagedIdentity parameter.

Type:	String
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-Parameter

De parameters die door het script worden gebruikt. Zie de sectie NOTES voor parametereigenschappen en het maken van een hash-tabel om deze samen te stellen.

Type:	IRunCommandInputParameter[]
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-ProtectedParameter

De parameters die door het script worden gebruikt. Zie de sectie NOTES voor PROTECTEDPARAMETER-eigenschappen en maak een hash-tabel om deze samen te stellen.

Type:	IRunCommandInputParameter[]
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-ResourceGroupName

De naam van de resourcegroep.

Type:	String
Position:	Named
Default value:	None
Vereist:	True
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-RunAsPassword

Hiermee geeft u het wachtwoord voor het gebruikersaccount op de virtuele machine op bij het uitvoeren van de opdracht uitvoeren.

Type:	String
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-RunAsUser

Hiermee geeft u het gebruikersaccount op de virtuele machine bij het uitvoeren van de opdracht uitvoeren.

Type:	String
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-RunCommandName

De naam van de opdracht voor het uitvoeren van de virtuele machine.

Type:	String
Position:	Named
Default value:	None
Vereist:	True
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-ScriptLocalPath

Type:	String
Position:	Named
Default value:	None
Vereist:	True
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-ScriptUriManagedIdentityClientId

Client-id (GUID-waarde) van de door de gebruiker toegewezen beheerde identiteit. ObjectId mag niet worden gebruikt als dit is opgegeven.

Type:	String
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-ScriptUriManagedIdentityObjectId

Object-id (GUID-waarde) van de door de gebruiker toegewezen beheerde identiteit. ClientId mag niet worden gebruikt als dit is opgegeven.

Type:	String
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-SourceCommandId

Hiermee geeft u een commandId van vooraf gedefinieerd ingebouwd script.

Type:	String
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-SourceScript

Hiermee geeft u de scriptinhoud op die moet worden uitgevoerd op de virtuele machine.

Type:	String
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-SourceScriptUri

Hiermee geeft u de locatie voor het downloaden van scripts op. Dit kan een SAS-URI zijn van een Azure Storage-blob met leestoegang of openbare URI.

Type:	String
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-SubscriptionId

Abonnementsreferenties die het Microsoft Azure-abonnement uniek identificeren. De abonnements-id maakt deel uit van de URI voor elke serviceoproep.

Type:	String
Position:	Named
Default value:	(Get-AzContext).Subscription.Id
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-Tag

Resourcetags

Type:	Hashtable
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-TimeoutInSecond

De time-out in seconden om de run-opdracht uit te voeren.

Type:	Int32
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-TreatFailureAsDeploymentFailure

Facultatief. Als deze optie is ingesteld op waar, mislukt een fout in het script de implementatie en wordt ProvisioningState gemarkeerd als Mislukt. Als deze optie is ingesteld op false, geeft ProvisioningState alleen aan of de run-opdracht al dan niet door het uitbreidingsplatform is uitgevoerd, wordt niet aangegeven of het script is mislukt in het geval van scriptfouten. Zie de exemplaarweergave van de uitvoeringsopdracht in het geval van scriptfouten om executionMessage, uitvoer, fout te zien: https://aka.ms/runcommandmanaged#get-execution-status-and-results

Type:	SwitchParameter
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-VMScaleSetName

De naam van de VM-schaalset.

Type:	String
Position:	Named
Default value:	None
Vereist:	True
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-WhatIf

Toont wat er zou gebeuren als de cmdlet wordt uitgevoerd. De cmdlet wordt niet uitgevoerd.

Type:	SwitchParameter
Aliassen:	wi
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

Uitvoerwaarden

IVirtualMachineRunCommand

Delen via

Set-AzVmssVMRunCommand

Syntaxis

Description

Voorbeelden

Voorbeeld 1: Opdracht Uitvoeren maken of bijwerken op een VMSS VM-exemplaar met behulp van een SAS-URL voor opslagblob

Voorbeeld 2: Voeropdracht maken of bijwerken op een VMSS-VM-exemplaar met behulp van een lokaal scriptbestand.

Voorbeeld 3: Voeropdracht maken of bijwerken op een VMSS VM-exemplaar met behulp van scripttekst.

Voorbeeld 4: Voeropdracht maken of bijwerken op een VMSS VM-exemplaar met behulp van commandId.

Voorbeeld 5: Voeropdracht maken of bijwerken op een VMSS VM-exemplaar en standaarduitvoer en standaardfoutberichten streamen naar uitvoer en fout Toevoeg-blobs.

Voorbeeld 6: Voer de opdracht Uitvoeren op een VMSS-VM-exemplaar te maken of bij te werken, voer de opdracht uitvoeren als een andere gebruiker uit met de parameters RunAsUser en RunAsPassword.

Parameters

-AsJob

-AsyncExecution

-Confirm

-DefaultProfile

-ErrorBlobManagedIdentityClientId

-ErrorBlobManagedIdentityObjectId

-ErrorBlobUri

-InstanceId

-Location

-NoWait

-OutputBlobManagedIdentityClientId

-OutputBlobManagedIdentityObjectId

-OutputBlobUri

-Parameter

-ProtectedParameter

-ResourceGroupName

-RunAsPassword

-RunAsUser

-RunCommandName

-ScriptLocalPath

-ScriptUriManagedIdentityClientId

-ScriptUriManagedIdentityObjectId

-SourceCommandId

-SourceScript

-SourceScriptUri

-SubscriptionId

-Tag

-TimeoutInSecond

-TreatFailureAsDeploymentFailure

-VMScaleSetName

-WhatIf

Uitvoerwaarden

Aanvullende resources