Set-AzVMRunCommand

Referensi

Modul:: Az.Compute

Operasi untuk membuat atau memperbarui perintah jalankan.

Sintaks

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>]

Deskripsi

Operasi untuk membuat atau memperbarui perintah jalankan.

Contoh

Contoh 1: Membuat atau memperbarui Jalankan Perintah pada VM menggunakan URL SAS blob penyimpanan

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

Buat atau perbarui Jalankan Perintah pada VM Windows menggunakan URL SAS dari blob penyimpanan yang berisi skrip .ps1. Catatan URL SAS harus menyediakan akses baca ke blob. Waktu kedaluwarsa 24 jam disarankan untuk URL SAS. URL SAS dapat dihasilkan pada portal Azure menggunakan opsi blob , atau token SAS menggunakan New-AzStorageBlobSASToken. Jika menghasilkan token SAS menggunakan New-AzStorageBlobSASToken, URL SAS Anda = URL blob dasar + "?" + token SAS dari New-AzStorageBlobSASToken.

Contoh 2: Membuat atau memperbarui Jalankan Perintah pada VM menggunakan file skrip lokal.

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

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

Buat atau perbarui Jalankan Perintah pada VM menggunakan file skrip lokal yang ada di komputer klien tempat cmdlet dijalankan.

Contoh 3: Membuat atau memperbarui Jalankan Perintah pada VM menggunakan teks skrip.

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

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

Buat atau perbarui Jalankan Perintah pada VM yang meneruskan konten skrip langsung ke parameter -SourceScript. Gunakan ';' untuk memisahkan beberapa perintah.

Contoh 4: Buat atau perbarui Jalankan Perintah pada VM menggunakan commandId.

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

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

Buat atau perbarui Jalankan Perintah pada VM menggunakan commandId yang sudah ada sebelumnya. CommandId yang tersedia dapat diambil menggunakan Get-AzVMRunCommandDocument.

Contoh 5: Buat atau perbarui Jalankan Perintah pada VM dan streaming output standar dan pesan kesalahan standar untuk output dan kesalahan Tambahkan 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

Buat atau perbarui Jalankan Perintah pada VM dan streaming output standar dan pesan kesalahan standar untuk output dan kesalahan Tambahkan blob. Output catatan dan blob kesalahan harus berjenis AppendBlob dan URL SAS-nya harus menyediakan akses baca, tambahkan, buat, tulis ke blob. Waktu kedaluwarsa 24 jam disarankan untuk URL SAS. Jika output atau blob kesalahan tidak ada, blob jenis AppendBlob akan dibuat. URL SAS dapat dihasilkan pada portal Azure menggunakan opsi blob , atau token SAS menggunakan New-AzStorageBlobSASToken. Jika menghasilkan token SAS menggunakan New-AzStorageBlobSASToken, URL SAS Anda = URL blob dasar + "?" + token SAS dari New-AzStorageBlobSASToken.

Contoh 6: Buat atau perbarui Jalankan Perintah pada VM, jalankan Perintah Jalankan sebagai pengguna yang berbeda menggunakan parameter RunAsUser dan 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

Buat atau perbarui Jalankan Perintah pada VM, jalankan Perintah Jalankan sebagai pengguna lain menggunakan parameter RunAsUser dan RunAsPassword. Agar RunAs berfungsi dengan baik, hubungi admin VM dan pastikan pengguna ditambahkan pada VM, pengguna memiliki akses ke sumber daya yang diakses oleh Perintah Jalankan (Direktori, File, Jaringan, dll.), dan jika VM Windows, layanan 'Masuk Sekunder' berjalan pada VM.

Parameter

-AsJob

Jalankan perintah sebagai pekerjaan

Jenis:	SwitchParameter
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

-AsyncExecution

Opsional. Jika diatur ke true, provisi akan selesai segera setelah skrip dimulai dan tidak akan menunggu skrip selesai.

Jenis:	SwitchParameter
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

-Confirm

Meminta Anda mengonfirmasi sebelum menjalankan cmdlet.

Jenis:	SwitchParameter
Alias:	cf
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

-DefaultProfile

Parameter DefaultProfile tidak berfungsi. Gunakan parameter SubscriptionId saat tersedia jika menjalankan cmdlet terhadap langganan yang berbeda.

Jenis:	PSObject
Alias:	AzureRMContext, AzureCredential
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

-ErrorBlobManagedIdentityClientId

Id Klien (nilai GUID) dari identitas terkelola yang ditetapkan pengguna. ObjectId tidak boleh digunakan jika ini disediakan.

Jenis:	String
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

-ErrorBlobManagedIdentityObjectId

Id Objek (nilai GUID) dari identitas terkelola yang ditetapkan pengguna. ClientId tidak boleh digunakan jika ini disediakan.

Jenis:	String
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

-ErrorBlobUri

Menentukan blob penyimpanan Azure tempat aliran kesalahan skrip akan diunggah. Gunakan URI SAS dengan baca, tambahkan, buat, tulis akses ATAU gunakan identitas terkelola untuk menyediakan akses VM ke blob. Lihat parameter errorBlobManagedIdentity.

Jenis:	String
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

-Location

Lokasi sumber daya

Jenis:	String
Position:	Named
Nilai default:	None
Diperlukan:	True
Terima input alur:	False
Terima karakter wildcard:	False

-NoWait

Jalankan perintah secara asinkron

Jenis:	SwitchParameter
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

-OutputBlobManagedIdentityClientId

Id Klien (nilai GUID) dari identitas terkelola yang ditetapkan pengguna. ObjectId tidak boleh digunakan jika ini disediakan.

Jenis:	String
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

-OutputBlobManagedIdentityObjectId

Id Objek (nilai GUID) dari identitas terkelola yang ditetapkan pengguna. ClientId tidak boleh digunakan jika ini disediakan.

Jenis:	String
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

-OutputBlobUri

Menentukan blob penyimpanan Azure tempat aliran output skrip akan diunggah. Gunakan URI SAS dengan baca, tambahkan, buat, tulis akses ATAU gunakan identitas terkelola untuk menyediakan akses VM ke blob. Lihat parameter outputBlobManagedIdentity.

Jenis:	String
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

-Parameter

Parameter yang digunakan oleh skrip. Untuk membuat, lihat bagian CATATAN untuk properti PARAMETER dan membuat tabel hash.

Jenis:	IRunCommandInputParameter[]
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

-ProtectedParameter

Parameter yang digunakan oleh skrip. Untuk membuat, lihat bagian CATATAN untuk properti PROTECTEDPARAMETER dan membuat tabel hash.

Jenis:	IRunCommandInputParameter[]
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

-ResourceGroupName

Nama grup sumber daya.

Jenis:	String
Position:	Named
Nilai default:	None
Diperlukan:	True
Terima input alur:	False
Terima karakter wildcard:	False

-RunAsPassword

Menentukan kata sandi akun pengguna pada VM saat menjalankan perintah jalankan.

Jenis:	String
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

-RunAsUser

Menentukan akun pengguna pada VM saat menjalankan perintah jalankan.

Jenis:	String
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

-RunCommandName

Nama perintah eksekusi komputer virtual.

Jenis:	String
Position:	Named
Nilai default:	None
Diperlukan:	True
Terima input alur:	False
Terima karakter wildcard:	False

-ScriptLocalPath

Jenis:	String
Position:	Named
Nilai default:	None
Diperlukan:	True
Terima input alur:	False
Terima karakter wildcard:	False

-ScriptUriManagedIdentityClientId

Id Klien (nilai GUID) dari identitas terkelola yang ditetapkan pengguna. ObjectId tidak boleh digunakan jika ini disediakan.

Jenis:	String
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

-ScriptUriManagedIdentityObjectId

Id Objek (nilai GUID) dari identitas terkelola yang ditetapkan pengguna. ClientId tidak boleh digunakan jika ini disediakan.

Jenis:	String
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

-SourceCommandId

Menentukan commandId dari skrip bawaan yang telah ditentukan sebelumnya.

Jenis:	String
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

-SourceScript

Menentukan konten skrip yang akan dijalankan pada VM.

Jenis:	String
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

-SourceScriptUri

Menentukan lokasi pengunduhan skrip. Ini dapat berupa URI SAS dari blob penyimpanan Azure dengan akses baca atau URI publik.

Jenis:	String
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

-SubscriptionId

Kredensial langganan yang secara unik mengidentifikasi langganan Microsoft Azure. ID langganan membentuk bagian dari URI untuk setiap panggilan layanan.

Jenis:	String
Position:	Named
Nilai default:	(Get-AzContext).Subscription.Id
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

-Tag

Tag sumber daya

Jenis:	Hashtable
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

-TimeoutInSecond

Batas waktu dalam detik untuk menjalankan perintah jalankan.

Jenis:	Int32
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

-TreatFailureAsDeploymentFailure

Opsional. Jika diatur ke true, kegagalan apa pun dalam skrip akan gagal penyebaran dan ProvisioningState akan ditandai sebagai Gagal. Jika diatur ke false, ProvisioningState hanya akan mencerminkan apakah perintah eksekusi dijalankan atau tidak oleh platform ekstensi, itu tidak akan menunjukkan apakah skrip gagal jika terjadi kegagalan skrip. Lihat tampilan instans perintah jalankan jika terjadi kegagalan skrip untuk melihat executionMessage, output, kesalahan: https://aka.ms/runcommandmanaged#get-execution-status-and-results

Jenis:	SwitchParameter
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

-VMName

Nama komputer virtual tempat perintah jalankan harus dibuat atau diperbarui.

Jenis:	String
Position:	Named
Nilai default:	None
Diperlukan:	True
Terima input alur:	False
Terima karakter wildcard:	False

-WhatIf

Menunjukkan apa yang akan terjadi jika cmdlet berjalan. Cmdlet tidak dijalankan.

Jenis:	SwitchParameter
Alias:	wi
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

Output

IVirtualMachineRunCommand

Bagikan melalui

Set-AzVMRunCommand

Sintaks

Deskripsi

Contoh

Contoh 1: Membuat atau memperbarui Jalankan Perintah pada VM menggunakan URL SAS blob penyimpanan

Contoh 2: Membuat atau memperbarui Jalankan Perintah pada VM menggunakan file skrip lokal.

Contoh 3: Membuat atau memperbarui Jalankan Perintah pada VM menggunakan teks skrip.

Contoh 4: Buat atau perbarui Jalankan Perintah pada VM menggunakan commandId.

Contoh 5: Buat atau perbarui Jalankan Perintah pada VM dan streaming output standar dan pesan kesalahan standar untuk output dan kesalahan Tambahkan blob.

Contoh 6: Buat atau perbarui Jalankan Perintah pada VM, jalankan Perintah Jalankan sebagai pengguna yang berbeda menggunakan parameter RunAsUser dan RunAsPassword.

Parameter

-AsJob

-AsyncExecution

-Confirm

-DefaultProfile

-ErrorBlobManagedIdentityClientId

-ErrorBlobManagedIdentityObjectId

-ErrorBlobUri

-Location

-NoWait

-OutputBlobManagedIdentityClientId

-OutputBlobManagedIdentityObjectId

-OutputBlobUri

-Parameter

-ProtectedParameter

-ResourceGroupName

-RunAsPassword

-RunAsUser

-RunCommandName

-ScriptLocalPath

-ScriptUriManagedIdentityClientId

-ScriptUriManagedIdentityObjectId

-SourceCommandId

-SourceScript

-SourceScriptUri

-SubscriptionId

-Tag

-TimeoutInSecond

-TreatFailureAsDeploymentFailure

-VMName

-WhatIf

Output

Sumber Daya Tambahan: