Set-AzVMRunCommand
De bewerking voor het maken of bijwerken van de opdracht uitvoeren.
Syntax
Set-AzVMRunCommand
-ResourceGroupName <String>
-RunCommandName <String>
-VMName <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-AzVMRunCommand
-ResourceGroupName <String>
-RunCommandName <String>
-VMName <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 uitvoeren.
Voorbeelden
Voorbeeld 1: Opdracht Uitvoeren op een VIRTUELE machine maken of bijwerken met behulp van een SAS-URL voor opslagblob
Set-AzVMRunCommand -ResourceGroupName MyRG0 -VMName MyVMEE -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/runCommandsOpdracht Uitvoeren op een Windows-VM maken of bijwerken 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: Opdracht Uitvoeren op een VIRTUELE machine maken of bijwerken met behulp van een lokaal scriptbestand.
Set-AzVMRunCommand -ResourceGroupName MyRG0 -VMName MyVMEE -RunCommandName MyRunCommand -Location EastUS2EUAP -ScriptLocalPath "C:\MyScriptsDir\MyScript.ps1"
Location Name Type
-------- ---- ----
eastus2euap MyRunCommand Microsoft.Compute/virtualMachines/runCommandsMaak of werk de opdracht Uitvoeren op een VIRTUELE machine bij met behulp van een lokaal scriptbestand dat zich op de clientcomputer bevindt waarop de cmdlet wordt uitgevoerd.
Voorbeeld 3: Een opdracht uitvoeren op een virtuele machine maken of bijwerken met behulp van scripttekst.
Set-AzVMRunCommand -ResourceGroupName MyRG0 -VMName MyVML -RunCommandName MyRunCommand2 -Location EastUS2EUAP -SourceScript "id; echo HelloWorld"
Location Name Type
-------- ---- ----
eastus2euap MyRunCommand2 Microsoft.Compute/virtualMachines/runCommandsMaak of werk de opdracht Uitvoeren bij op een VIRTUELE machine die de scriptinhoud rechtstreeks doorgeeft aan de parameter -SourceScript. Gebruik ';' om meerdere opdrachten te scheiden.
Voorbeeld 4: Opdracht Uitvoeren op een VIRTUELE machine maken of bijwerken met behulp van commandId.
Set-AzVMRunCommand -ResourceGroupName MyRG0 -VMName MyVMEE -RunCommandName MyRunCommand -Location EastUS2EUAP -SourceCommandId DisableWindowsUpdate
Location Name Type
-------- ---- ----
eastus2euap MyRunCommand Microsoft.Compute/virtualMachines/runCommandsMaak of werk de opdracht Uitvoeren op een virtuele machine bij met behulp van een bestaande commandId. Beschikbare commandIds kunnen worden opgehaald met Get-AzVMRunCommandDocument.
Voorbeeld 5: Voeropdracht maken of bijwerken op een VIRTUELE machine en standaarduitvoer en standaardfoutberichten streamen naar uitvoer en fout Toevoeg-blobs.
Set-AzVMRunCommand -ResourceGroupName MyRG0 -VMName MyVML -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/runCommandsOpdracht Uitvoeren maken of bijwerken op een virtuele machine en standaarduitvoer en standaardfoutberichten streamen 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 VM uit als een andere gebruiker met de parameters RunAsUser en RunAsPassword.
Set-AzVMRunCommand -ResourceGroupName MyRG0 -VMName MyVMEE -RunCommandName MyRunCommand -Location EastUS2EUAP -ScriptLocalPath "C:\MyScriptsDir\MyScript.ps1" -RunAsUser myusername -RunAsPassword mypassword
Location Name Type
-------- ---- ----
eastus2euap MyRunCommand Microsoft.Compute/virtualMachines/runCommandsMaak of werk de opdracht Uitvoeren op een virtuele machine uit, voer de opdracht Uitvoeren uit als een andere gebruiker met de parameters RunAsUser en RunAsPassword. 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 |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-AsyncExecution
Optioneel. 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 |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Confirm
Hiermee wordt u gevraagd om bevestiging voordat u de cmdlet uitvoert.
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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 |
| Aliases: | AzureRMContext, AzureCredential |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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 |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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 |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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 |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Location
Resourcelocatie
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-NoWait
De opdracht asynchroon uitvoeren
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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 |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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 |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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 |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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 |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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 |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ResourceGroupName
De naam van de resourcegroep.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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 |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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 |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RunCommandName
De naam van de opdracht voor het uitvoeren van de virtuele machine.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ScriptLocalPath
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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 |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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 |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-SourceCommandId
Hiermee geeft u een commandId van vooraf gedefinieerd ingebouwd script.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-SourceScript
Hiermee geeft u de scriptinhoud op die moet worden uitgevoerd op de virtuele machine.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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 |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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 |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Tag
Resourcetags
| Type: | Hashtable |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-TimeoutInSecond
De time-out in seconden om de run-opdracht uit te voeren.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-TreatFailureAsDeploymentFailure
Optioneel. 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. Bekijk 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 |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-VMName
De naam van de virtuele machine waarop de run-opdracht moet worden gemaakt of bijgewerkt.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-WhatIf
Hiermee wordt weergegeven wat er zou gebeuren als u de cmdlet uitvoert. De cmdlet wordt niet uitgevoerd.
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Uitvoerwaarden
Azure PowerShell
Feedback
Binnenkort beschikbaar: In de loop van 2024 zullen we GitHub-problemen geleidelijk uitfaseren als het feedbackmechanisme voor inhoud en deze vervangen door een nieuw feedbacksysteem. Zie voor meer informatie: https://aka.ms/ContentUserFeedback.
Feedback verzenden en weergeven voor