Set-AzVmssVMRunCommand
A VMSS virtuális gép futtatási parancsának létrehozásához vagy frissítéséhez szükséges művelet.
Syntax
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
A VMSS virtuális gép futtatási parancsának 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 VMSS virtuálisgép-példányon tárolóblob SAS URL-cím használatával
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
Parancs létrehozása vagy frissítése Windows VMSS virtuálisgép-példányon 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 VMSS virtuálisgép-példányon helyi szkriptfájl használatával.
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
Hozzon létre vagy frissítse a Futtatás parancsot egy VMSS virtuálisgép-példányon 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 VMSS virtuálisgép-példányon szkriptszöveg használatával.
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
Hozzon létre vagy frissítse a Futtatás parancsot egy VMSS virtuálisgép-példányon, 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 VMSS virtuálisgép-példányon a commandId használatával.
Set-AzVmssVMRunCommand -ResourceGroupName MyRG0 -VMScaleSetName MyVMSS -InstanceId 0 -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 VMSS virtuálisgép-példányon 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 egy VMSS virtuálisgép-példányon, és streamelje a standard kimenetet és a standard hibaüzeneteket a kimenetre és a hiba hozzáfűzési blobjaira.
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
Hozzon létre vagy frissítse a Futtatás parancsot egy VMSS virtuálisgép-példányon, és streamelje a szabványos kimenetet és a szabványos hibaüzeneteket a kimenetre és a hiba hozzáfűzési blobjaira. 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: Futtassa a parancsot egy VMSS virtuálisgép-példányon, és futtassa a Futtatás parancsot másik felhasználóként a RunAsUser és a RunAsPassword paraméterekkel.
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
Hozzon létre vagy frissítse a Futtatás parancsot egy VMSS virtuálisgép-példányon, 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
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Confirm
Jóváhagyást kér a parancsmag futtatása előtt.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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ő.
Type: | PSObject |
Aliases: | AzureRMContext, AzureCredential |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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ó.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InstanceId
A virtuális gép példányazonosítója.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Location
Erőforrás helye
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-NoWait
A parancs aszinkron futtatása
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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ó.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Type: | IRunCommandInputParameter[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Type: | IRunCommandInputParameter[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ResourceGroupName
Az erőforráscsoport neve.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RunAsPassword
Megadja a felhasználói fiók jelszavát a virtuális gépen a futtatási parancs végrehajtásakor.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RunAsUser
Megadja a virtuális gép felhasználói fiókját a futtatási parancs végrehajtásakor.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RunCommandName
A virtuális gép futtatási parancsának neve.
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
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ó.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SourceCommandId
Előre definiált beépített szkript parancsazonosítóját adja meg.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SourceScript
Megadja a virtuális gépen végrehajtandó szkripttartalmat.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Type: | String |
Position: | Named |
Default value: | (Get-AzContext).Subscription.Id |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Tag
Erőforráscímkék
Type: | Hashtable |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-TimeoutInSecond
A futtatási parancs végrehajtásának időtúllépése másodpercben.
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-VMScaleSetName
A virtuálisgép-méretezési csoport neve.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
Bemutatja, mi történne a parancsmag futtatásakor. A parancsmag nem fut.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Kimenetek
Visszajelzés
https://aka.ms/ContentUserFeedback.
Hamarosan elérhető: 2024-ben fokozatosan kivezetjük a GitHub-problémákat a tartalom visszajelzési mechanizmusaként, és lecseréljük egy új visszajelzési rendszerre. További információ:Visszajelzés küldése és megtekintése a következőhöz: