Megosztás a következőn keresztül:

Set-AzVMRunCommand

  • Referencia
Modul:
Az.Compute

A futtatási parancs létrehozásához vagy frissítéséhez szükséges művelet.

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

A futtatási parancs létrehozásához vagy frissítéséhez szükséges művelet.

Példák

1. példa: Futtatási parancs létrehozása vagy frissítése virtuális gépen tárolóblob SAS URL-cím használatával

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/runCommands

Hozzon létre vagy frissítse a Futtatás parancsot windowsos virtuális gépen egy .ps1 szkriptet tartalmazó tárolóblob SAS URL-címével. Megjegyzés: Az SAS URL-címnek olvasási hozzáférést kell biztosítania a blobhoz. Az SAS URL-cím esetében a lejárati idő 24 óra. Az SAS-URL-címek blobbeállítások vagy SAS-jogkivonatok használatával hozhatók létre az Azure Portalon a New-AzStorageBlobSASToken használatával. Ha SAS-jogkivonatot hoz létre a New-AzStorageBlobSASToken használatával, akkor a SAS URL= alap blob URL-címe + "?" + SAS-jogkivonat a New-AzStorageBlobSASTokenből.

2. példa: Parancs létrehozása vagy frissítése virtuális gépen helyi szkriptfájl használatával.

Set-AzVMRunCommand -ResourceGroupName MyRG0 -VMName MyVMEE -RunCommandName MyRunCommand -Location EastUS2EUAP -ScriptLocalPath "C:\MyScriptsDir\MyScript.ps1"

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

Hozzon létre vagy frissítse a Futtatás parancsot egy virtuális gépen egy helyi szkriptfájl használatával, amely azon az ügyfélszámítógépen található, amelyen a parancsmag végrehajtása történik.

3. példa: Parancs létrehozása vagy frissítése egy virtuális gépen szkriptszöveg használatával.

Set-AzVMRunCommand -ResourceGroupName MyRG0 -VMName MyVML -RunCommandName MyRunCommand2 -Location EastUS2EUAP -SourceScript "id; echo HelloWorld"

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

Hozzon létre vagy frissítse a Futtatás parancsot egy olyan virtuális gépen, amely közvetlenül a -SourceScript paraméternek adja át a szkript tartalmát. Több parancs elválasztásához használja a ";" parancsot.

4. példa: Parancs létrehozása vagy frissítése virtuális gépen a commandId használatával.

Set-AzVMRunCommand -ResourceGroupName MyRG0 -VMName MyVMEE -RunCommandName MyRunCommand -Location EastUS2EUAP -SourceCommandId DisableWindowsUpdate

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

Hozzon létre vagy frissítse a Futtatás parancsot egy virtuális gépen a már meglévő commandId használatával. Az elérhető commandId-eket a Get-AzVMRunCommandDocument használatával lehet lekérni.

5. példa: Futtassa a parancsot virtuális gépen, és streamelje a szabványos kimenetet, valamint a standard hibaüzeneteket a kimenethez és a hiba hozzáfűző blobokhoz.

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/runCommands

Hozzon létre vagy frissítse a futtatási parancsot egy virtuális gépen, és streamelje a szabványos kimenetet és a szabványos hibaüzeneteket a kimenethez és a hiba hozzáfűzési blobokhoz. A megjegyzés kimenetének és hibablobjainak AppendBlob típusúnak kell lenniük, és SAS-URL-címüknek olvasási, hozzáfűzési, létrehozási, írási hozzáférést kell biztosítaniuk a blobhoz. Az SAS URL-cím esetében a lejárati idő 24 óra. Ha a kimenet vagy hibablob nem létezik, létrejön egy AppendBlob típusú blob. Az SAS-URL-címek blobbeállítások vagy SAS-jogkivonatok használatával hozhatók létre az Azure Portalon a New-AzStorageBlobSASToken használatával. Ha SAS-jogkivonatot hoz létre a New-AzStorageBlobSASToken használatával, akkor a SAS URL= alap blob URL-címe + "?" + SAS-jogkivonat a New-AzStorageBlobSASTokenből.

6. példa: Futtatási parancs létrehozása vagy frissítése egy virtuális gépen, futtassa a futtatási parancsot másik felhasználóként a RunAsUser és a RunAsPassword paraméterekkel.

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/runCommands

Hozzon létre vagy frissítse a Futtatás parancsot egy virtuális gépen, futtassa a futtatási parancsot másik felhasználóként a RunAsUser és a RunAsPassword paraméterekkel. Ahhoz, hogy a futtatók megfelelően működjenek, forduljon a virtuális gép rendszergazdájához, és győződjön meg arról, hogy a felhasználó hozzá van adva a virtuális géphez, a felhasználó hozzáfér a futtatási parancs által elért erőforrásokhoz (könyvtárak, fájlok, hálózat stb.), windowsos virtuális gép esetén pedig a "Másodlagos bejelentkezés" szolgáltatás fut a virtuális gépen.

Paraméterek

-AsJob

A parancs futtatása feladatként

Típus:SwitchParameter
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-AsyncExecution

Opcionális. Ha igaz értékre van állítva, a kiépítés a szkript indításakor azonnal befejeződik, és nem várja meg, amíg a szkript befejeződik.

Típus:SwitchParameter
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-Confirm

Jóváhagyást kér a parancsmag futtatása előtt.

Típus:SwitchParameter
Aliasok:cf
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-DefaultProfile

A DefaultProfile paraméter nem működik. Ha a parancsmagot egy másik előfizetésen hajtja végre, használja az SubscriptionId paramétert, ha elérhető.

Típus:PSObject
Aliasok:AzureRMContext, AzureCredential
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-ErrorBlobManagedIdentityClientId

A felhasználó által hozzárendelt felügyelt identitás ügyfélazonosítója (GUID-értéke). Ha ez meg van adva, az ObjectId nem használható.

Típus:String
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-ErrorBlobManagedIdentityObjectId

A felhasználó által hozzárendelt felügyelt identitás objektumazonosítója (GUID-értéke). A ClientId nem használható, ha ez meg van adva.

Típus:String
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-ErrorBlobUri

Megadja azt az Azure Storage-blobot, ahová a szkripthiba-stream fel lesz töltve. Sas URI használata olvasási, hozzáfűzési, létrehozási, írási hozzáféréssel vagy felügyelt identitással a virtuális gép blobhoz való hozzáférésének biztosításához. Tekintse meg a errorBlobManagedIdentity paramétert.

Típus:String
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-Location

Erőforrás helye

Típus:String
Position:Named
Alapértelmezett érték:None
Kötelező:True
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-NoWait

A parancs aszinkron futtatása

Típus:SwitchParameter
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-OutputBlobManagedIdentityClientId

A felhasználó által hozzárendelt felügyelt identitás ügyfélazonosítója (GUID-értéke). Ha ez meg van adva, az ObjectId nem használható.

Típus:String
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-OutputBlobManagedIdentityObjectId

A felhasználó által hozzárendelt felügyelt identitás objektumazonosítója (GUID-értéke). A ClientId nem használható, ha ez meg van adva.

Típus:String
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-OutputBlobUri

Megadja azt az Azure Storage-blobot, ahová a szkript kimeneti streamje fel lesz töltve. Sas URI használata olvasási, hozzáfűzési, létrehozási, írási hozzáféréssel vagy felügyelt identitással a virtuális gép blobhoz való hozzáférésének biztosításához. Tekintse meg a outputBlobManagedIdentity paramétert.

Típus:String
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-Parameter

A szkript által használt paraméterek. A létrehozáshoz tekintse meg a PARAMÉTER tulajdonságainak MEGJEGYZÉSEK szakaszát, és hozzon létre egy kivonattáblát.

Típus:IRunCommandInputParameter[]
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-ProtectedParameter

A szkript által használt paraméterek. A létrehozáshoz tekintse meg a PROTECTEDPARAMETER tulajdonságok JEGYZETek szakaszát, és hozzon létre egy kivonattáblát.

Típus:IRunCommandInputParameter[]
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-ResourceGroupName

Az erőforráscsoport neve.

Típus:String
Position:Named
Alapértelmezett érték:None
Kötelező:True
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-RunAsPassword

Megadja a felhasználói fiók jelszavát a virtuális gépen a futtatási parancs végrehajtásakor.

Típus:String
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-RunAsUser

Megadja a virtuális gép felhasználói fiókját a futtatási parancs végrehajtásakor.

Típus:String
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-RunCommandName

A virtuális gép futtatási parancsának neve.

Típus:String
Position:Named
Alapértelmezett érték:None
Kötelező:True
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-ScriptLocalPath

Típus:String
Position:Named
Alapértelmezett érték:None
Kötelező:True
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-ScriptUriManagedIdentityClientId

A felhasználó által hozzárendelt felügyelt identitás ügyfélazonosítója (GUID-értéke). Ha ez meg van adva, az ObjectId nem használható.

Típus:String
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-ScriptUriManagedIdentityObjectId

A felhasználó által hozzárendelt felügyelt identitás objektumazonosítója (GUID-értéke). A ClientId nem használható, ha ez meg van adva.

Típus:String
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-SourceCommandId

Előre definiált beépített szkript parancsazonosítóját adja meg.

Típus:String
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-SourceScript

Megadja a virtuális gépen végrehajtandó szkripttartalmat.

Típus:String
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-SourceScriptUri

Megadja a szkript letöltési helyét. Ez lehet egy olvasási hozzáféréssel rendelkező Azure Storage-blob SAS URI-ja, vagy nyilvános URI.

Típus:String
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-SubscriptionId

Az előfizetés hitelesítő adatai, amelyek egyedileg azonosítják a Microsoft Azure-előfizetést. Az előfizetés azonosítója minden szolgáltatáshíváshoz az URI részét képezi.

Típus:String
Position:Named
Alapértelmezett érték:(Get-AzContext).Subscription.Id
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-Tag

Erőforráscímkék

Típus:Hashtable
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-TimeoutInSecond

A futtatási parancs végrehajtásának időtúllépése másodpercben.

Típus:Int32
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-TreatFailureAsDeploymentFailure

Opcionális. Ha igaz értékre van állítva, a szkript minden hibája meghiúsul, a ProvisioningState pedig sikertelenként lesz megjelölve. Ha hamis értékre van állítva, a ProvisioningState csak azt tükrözné, hogy a futtatási parancsot a bővítményplatform futtatta-e, nem jelzi, hogy szkripthiba esetén a szkript meghiúsult-e. A futtatási parancs példánynézete szkripthibák esetén a végrehajtásmessage, a kimenet és a hiba megtekintéséhez: https://aka.ms/runcommandmanaged#get-execution-status-and-results

Típus:SwitchParameter
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-VMName

Annak a virtuális gépnek a neve, amelyben létre kell hozni vagy frissíteni kell a futtatási parancsot.

Típus:String
Position:Named
Alapértelmezett érték:None
Kötelező:True
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-WhatIf

Bemutatja, mi történne a parancsmag futtatásakor. A parancsmag nem fut.

Típus:SwitchParameter
Aliasok:wi
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

Kimenetek

IVirtualMachineRunCommand