Set-AzVMRunCommand
Operazione da creare o aggiornare il comando di esecuzione.
Sintassi
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>]
Descrizione
Operazione da creare o aggiornare il comando di esecuzione.
Esempio
Esempio 1: Creare o aggiornare Esegui comando in una macchina virtuale usando un URL di firma di accesso condiviso DEL BLOB di archiviazione
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
Creare o aggiornare Esegui comando in una macchina virtuale Windows usando un URL di firma di accesso condiviso di un BLOB di archiviazione contenente lo script ps1. Nota L'URL della firma di accesso condiviso deve fornire l'accesso in lettura al BLOB. Per l'URL della firma di accesso condiviso è consigliata una scadenza di 24 ore. Gli URL di firma di accesso condiviso possono essere generati in portale di Azure usando le opzioni del BLOB o il token di firma di accesso condiviso usando New-Az Archiviazione BlobSASToken. Se si genera un token di firma di accesso condiviso con New-Az Archiviazione BlobSASToken, l'URL sas = URL BLOB di base + "?" + token SAS da New-Az Archiviazione BlobSASToken.
Esempio 2: Creare o aggiornare Esegui comando in una macchina virtuale usando un file di script locale.
Set-AzVMRunCommand -ResourceGroupName MyRG0 -VMName MyVMEE -RunCommandName MyRunCommand -Location EastUS2EUAP -ScriptLocalPath "C:\MyScriptsDir\MyScript.ps1"
Location Name Type
-------- ---- ----
eastus2euap MyRunCommand Microsoft.Compute/virtualMachines/runCommands
Creare o aggiornare Esegui comando in una macchina virtuale usando un file di script locale presente nel computer client in cui viene eseguito il cmdlet.
Esempio 3: Creare o aggiornare Esegui comando in una macchina virtuale usando il testo dello script.
Set-AzVMRunCommand -ResourceGroupName MyRG0 -VMName MyVML -RunCommandName MyRunCommand2 -Location EastUS2EUAP -SourceScript "id; echo HelloWorld"
Location Name Type
-------- ---- ----
eastus2euap MyRunCommand2 Microsoft.Compute/virtualMachines/runCommands
Creare o aggiornare Esegui comando in una macchina virtuale passando il contenuto dello script direttamente al parametro -SourceScript. Usare ';' per delimitare più comandi.
Esempio 4: Creare o aggiornare Esegui comando in una macchina virtuale usando commandId.
Set-AzVMRunCommand -ResourceGroupName MyRG0 -VMName MyVMEE -RunCommandName MyRunCommand -Location EastUS2EUAP -SourceCommandId DisableWindowsUpdate
Location Name Type
-------- ---- ----
eastus2euap MyRunCommand Microsoft.Compute/virtualMachines/runCommands
Creare o aggiornare Esegui comando in una macchina virtuale usando commandId preesistente. I commandId disponibili possono essere recuperati usando Get-AzVMRunCommandDocument.
Esempio 5: Creare o aggiornare Esegui comando in una macchina virtuale e trasmettere l'output standard e i messaggi di errore standard per l'output e l'errore Append BLOB.
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
Creare o aggiornare Esegui comando in una macchina virtuale e trasmettere l'output standard e i messaggi di errore standard per l'output e l'errore Append BLOB. Gli output delle note e i BLOB di errore devono essere di tipo AppendBlob e i relativi URL di firma di accesso condiviso devono fornire l'accesso in lettura, accodamento, creazione, scrittura al BLOB. Per l'URL della firma di accesso condiviso è consigliata una scadenza di 24 ore. Se il BLOB di output o di errore non esiste, verrà creato un BLOB di tipo BLOB di accodamento. Gli URL di firma di accesso condiviso possono essere generati in portale di Azure usando le opzioni del BLOB o il token di firma di accesso condiviso usando New-Az Archiviazione BlobSASToken. Se si genera un token di firma di accesso condiviso con New-Az Archiviazione BlobSASToken, l'URL sas = URL BLOB di base + "?" + token SAS da New-Az Archiviazione BlobSASToken.
Esempio 6: Creare o aggiornare Esegui comando in una macchina virtuale, eseguire Il comando di esecuzione come utente diverso usando i parametri RunAsUser e 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/runCommands
Creare o aggiornare Esegui comando in una macchina virtuale, eseguire il comando Esegui come utente diverso usando i parametri RunAsUser e RunAsPassword. Affinché RunAs funzioni correttamente, contattare l'amministratore della macchina virtuale e assicurarsi che l'utente venga aggiunto nella macchina virtuale, l'utente abbia accesso alle risorse a cui accede il comando Esegui (directory, file, rete e così via) e, in caso di macchina virtuale Windows, il servizio "Accesso secondario" è in esecuzione nella macchina virtuale.
Parametri
-AsJob
Eseguire il comando come processo
Tipo: | SwitchParameter |
Position: | Named |
valore predefinito: | None |
Necessario: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AsyncExecution
Facoltativo. Se impostato su true, il provisioning verrà completato non appena viene avviato lo script e non attenderà il completamento dello script.
Tipo: | SwitchParameter |
Position: | Named |
valore predefinito: | None |
Necessario: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Confirm
Richiede conferma prima di eseguire il cmdlet.
Tipo: | SwitchParameter |
Aliases: | cf |
Position: | Named |
valore predefinito: | None |
Necessario: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DefaultProfile
Il parametro DefaultProfile non è funzionale. Usare il parametro SubscriptionId quando disponibile se si esegue il cmdlet su una sottoscrizione diversa.
Tipo: | PSObject |
Aliases: | AzureRMContext, AzureCredential |
Position: | Named |
valore predefinito: | None |
Necessario: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ErrorBlobManagedIdentityClientId
ID client (valore GUID) dell'identità gestita assegnata dall'utente. ObjectId non deve essere utilizzato se specificato.
Tipo: | String |
Position: | Named |
valore predefinito: | None |
Necessario: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ErrorBlobManagedIdentityObjectId
ID oggetto (valore GUID) dell'identità gestita assegnata dall'utente. ClientId non deve essere usato se specificato.
Tipo: | String |
Position: | Named |
valore predefinito: | None |
Necessario: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ErrorBlobUri
Specifica il BLOB di archiviazione di Azure in cui verrà caricato il flusso di errori dello script. Usare un URI di firma di accesso condiviso con lettura, aggiunta, creazione, accesso in scrittura O usare l'identità gestita per fornire alla macchina virtuale l'accesso al BLOB. Fare riferimento al parametro errorBlobManagedIdentity.
Tipo: | String |
Position: | Named |
valore predefinito: | None |
Necessario: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Location
Posizione della risorsa
Tipo: | String |
Position: | Named |
valore predefinito: | None |
Necessario: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-NoWait
Eseguire il comando in modo asincrono
Tipo: | SwitchParameter |
Position: | Named |
valore predefinito: | None |
Necessario: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-OutputBlobManagedIdentityClientId
ID client (valore GUID) dell'identità gestita assegnata dall'utente. ObjectId non deve essere utilizzato se specificato.
Tipo: | String |
Position: | Named |
valore predefinito: | None |
Necessario: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-OutputBlobManagedIdentityObjectId
ID oggetto (valore GUID) dell'identità gestita assegnata dall'utente. ClientId non deve essere usato se specificato.
Tipo: | String |
Position: | Named |
valore predefinito: | None |
Necessario: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-OutputBlobUri
Specifica il BLOB di archiviazione di Azure in cui verrà caricato il flusso di output dello script. Usare un URI di firma di accesso condiviso con lettura, aggiunta, creazione, accesso in scrittura O usare l'identità gestita per fornire alla macchina virtuale l'accesso al BLOB. Fare riferimento al parametro outputBlobManagedIdentity.
Tipo: | String |
Position: | Named |
valore predefinito: | None |
Necessario: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Parameter
Parametri utilizzati dallo script. Per costruire, vedere la sezione NOTES per le proprietà PARAMETER e creare una tabella hash.
Tipo: | IRunCommandInputParameter[] |
Position: | Named |
valore predefinito: | None |
Necessario: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ProtectedParameter
Parametri utilizzati dallo script. Per costruire, vedere la sezione NOTES per le proprietà PROTECTEDPARAMETER e creare una tabella hash.
Tipo: | IRunCommandInputParameter[] |
Position: | Named |
valore predefinito: | None |
Necessario: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ResourceGroupName
Nome del gruppo di risorse.
Tipo: | String |
Position: | Named |
valore predefinito: | None |
Necessario: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RunAsPassword
Specifica la password dell'account utente nella macchina virtuale durante l'esecuzione del comando di esecuzione.
Tipo: | String |
Position: | Named |
valore predefinito: | None |
Necessario: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RunAsUser
Specifica l'account utente nella macchina virtuale durante l'esecuzione del comando di esecuzione.
Tipo: | String |
Position: | Named |
valore predefinito: | None |
Necessario: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RunCommandName
Nome del comando run della macchina virtuale.
Tipo: | String |
Position: | Named |
valore predefinito: | None |
Necessario: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ScriptLocalPath
Tipo: | String |
Position: | Named |
valore predefinito: | None |
Necessario: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ScriptUriManagedIdentityClientId
ID client (valore GUID) dell'identità gestita assegnata dall'utente. ObjectId non deve essere utilizzato se specificato.
Tipo: | String |
Position: | Named |
valore predefinito: | None |
Necessario: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ScriptUriManagedIdentityObjectId
ID oggetto (valore GUID) dell'identità gestita assegnata dall'utente. ClientId non deve essere usato se specificato.
Tipo: | String |
Position: | Named |
valore predefinito: | None |
Necessario: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SourceCommandId
Specifica un commandId di script predefinito predefinito.
Tipo: | String |
Position: | Named |
valore predefinito: | None |
Necessario: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SourceScript
Specifica il contenuto dello script da eseguire nella macchina virtuale.
Tipo: | String |
Position: | Named |
valore predefinito: | None |
Necessario: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SourceScriptUri
Specifica il percorso di download dello script. Può essere un URI di firma di accesso condiviso di un BLOB di archiviazione di Azure con accesso in lettura o URI pubblico.
Tipo: | String |
Position: | Named |
valore predefinito: | None |
Necessario: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SubscriptionId
Credenziali di sottoscrizione che identificano in modo univoco la sottoscrizione di Microsoft Azure. L'ID sottoscrizione fa parte dell'URI per ogni chiamata di servizio.
Tipo: | String |
Position: | Named |
valore predefinito: | (Get-AzContext).Subscription.Id |
Necessario: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Tag
Tag delle risorse
Tipo: | Hashtable |
Position: | Named |
valore predefinito: | None |
Necessario: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-TimeoutInSecond
Timeout in secondi per eseguire il comando di esecuzione.
Tipo: | Int32 |
Position: | Named |
valore predefinito: | None |
Necessario: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-TreatFailureAsDeploymentFailure
Facoltativo. Se impostato su true, qualsiasi errore nello script non riuscirà la distribuzione e ProvisioningState verrà contrassegnato come Non riuscito. Se impostato su false, ProvisioningState riflette solo se il comando di esecuzione è stato eseguito o meno dalla piattaforma delle estensioni, non indicherà se lo script non è riuscito in caso di errori di script. Vedere la visualizzazione dell'istanza del comando di esecuzione in caso di errori di script per visualizzare executionMessage, output, error: https://aka.ms/runcommandmanaged#get-execution-status-and-results
Tipo: | SwitchParameter |
Position: | Named |
valore predefinito: | None |
Necessario: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-VMName
Nome della macchina virtuale in cui deve essere creato o aggiornato il comando di esecuzione.
Tipo: | String |
Position: | Named |
valore predefinito: | None |
Necessario: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
Mostra gli effetti dell'esecuzione del cmdlet. Il cmdlet non viene eseguito.
Tipo: | SwitchParameter |
Aliases: | wi |
Position: | Named |
valore predefinito: | None |
Necessario: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |