Set-AzVmssVMRunCommand
Operasi untuk membuat atau memperbarui perintah jalankan VMSS VM.
Sintaks
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>]
Deskripsi
Operasi untuk membuat atau memperbarui perintah jalankan VMSS VM.
Contoh
Contoh 1: Membuat atau memperbarui Jalankan Perintah pada instans VMSS VM menggunakan URL SAS blob penyimpanan
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
Buat atau perbarui Jalankan Perintah pada instans VM VMSS Windows menggunakan URL SAS 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 instans VMSS VM menggunakan file skrip lokal.
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
Buat atau perbarui Jalankan Perintah pada instans VMSS VM menggunakan file skrip lokal yang ada di komputer klien tempat cmdlet dijalankan.
Contoh 3: Membuat atau memperbarui Jalankan Perintah pada instans VMSS VM menggunakan teks skrip.
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
Buat atau perbarui Jalankan Perintah pada instans VMSS VM yang meneruskan konten skrip langsung ke parameter -SourceScript. Gunakan ';' untuk memisahkan beberapa perintah.
Contoh 4: Buat atau perbarui Jalankan Perintah pada instans VMSS VM menggunakan commandId.
Set-AzVmssVMRunCommand -ResourceGroupName MyRG0 -VMScaleSetName MyVMSS -InstanceId 0 -RunCommandName MyRunCommand -Location EastUS2EUAP -SourceCommandId DisableWindowsUpdate
Location Name Type
-------- ---- ----
eastus2euap MyRunCommand Microsoft.Compute/virtualMachines/runCommands
Buat atau perbarui Jalankan Perintah pada instans VMSS VM menggunakan commandId yang sudah ada sebelumnya. CommandId yang tersedia dapat diambil menggunakan Get-AzVMRunCommandDocument.
Contoh 5: Buat atau perbarui Jalankan Perintah pada instans VMSS VM dan streaming output standar dan pesan kesalahan standar untuk output dan kesalahan Tambahkan blob.
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
Buat atau perbarui Jalankan Perintah pada instans VMSS 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 instans VMSS VM, jalankan Perintah Jalankan sebagai pengguna yang berbeda menggunakan parameter RunAsUser dan RunAsPassword.
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
Buat atau perbarui Jalankan Perintah pada instans VMSS VM, jalankan Perintah Jalankan sebagai pengguna yang berbeda 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 |
Accept pipeline input: | False |
Accept wildcard characters: | 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 |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Confirm
Meminta Anda mengonfirmasi sebelum menjalankan cmdlet.
Jenis: | SwitchParameter |
Aliases: | cf |
Position: | Named |
nilai default: | None |
Diperlukan: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DefaultProfile
Parameter DefaultProfile tidak berfungsi. Gunakan parameter SubscriptionId saat tersedia jika menjalankan cmdlet terhadap langganan yang berbeda.
Jenis: | PSObject |
Aliases: | AzureRMContext, AzureCredential |
Position: | Named |
nilai default: | None |
Diperlukan: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 |
Accept pipeline input: | False |
Accept wildcard characters: | 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 |
Accept pipeline input: | False |
Accept wildcard characters: | 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 |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InstanceId
ID instans komputer virtual.
Jenis: | String |
Position: | Named |
nilai default: | None |
Diperlukan: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Location
Lokasi sumber daya
Jenis: | String |
Position: | Named |
nilai default: | None |
Diperlukan: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-NoWait
Jalankan perintah secara asinkron
Jenis: | SwitchParameter |
Position: | Named |
nilai default: | None |
Diperlukan: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 |
Accept pipeline input: | False |
Accept wildcard characters: | 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 |
Accept pipeline input: | False |
Accept wildcard characters: | 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 |
Accept pipeline input: | False |
Accept wildcard characters: | 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 |
Accept pipeline input: | False |
Accept wildcard characters: | 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 |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ResourceGroupName
Nama grup sumber daya.
Jenis: | String |
Position: | Named |
nilai default: | None |
Diperlukan: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RunAsPassword
Menentukan kata sandi akun pengguna pada VM saat menjalankan perintah jalankan.
Jenis: | String |
Position: | Named |
nilai default: | None |
Diperlukan: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RunAsUser
Menentukan akun pengguna pada VM saat menjalankan perintah jalankan.
Jenis: | String |
Position: | Named |
nilai default: | None |
Diperlukan: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RunCommandName
Nama perintah eksekusi komputer virtual.
Jenis: | String |
Position: | Named |
nilai default: | None |
Diperlukan: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ScriptLocalPath
Jenis: | String |
Position: | Named |
nilai default: | None |
Diperlukan: | True |
Accept pipeline input: | False |
Accept wildcard characters: | 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 |
Accept pipeline input: | False |
Accept wildcard characters: | 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 |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SourceCommandId
Menentukan commandId dari skrip bawaan yang telah ditentukan sebelumnya.
Jenis: | String |
Position: | Named |
nilai default: | None |
Diperlukan: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SourceScript
Menentukan konten skrip yang akan dijalankan pada VM.
Jenis: | String |
Position: | Named |
nilai default: | None |
Diperlukan: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 |
Accept pipeline input: | False |
Accept wildcard characters: | 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 |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Tag
Tag sumber daya
Jenis: | Hashtable |
Position: | Named |
nilai default: | None |
Diperlukan: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-TimeoutInSecond
Batas waktu dalam detik untuk menjalankan perintah jalankan.
Jenis: | Int32 |
Position: | Named |
nilai default: | None |
Diperlukan: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-VMScaleSetName
Nama set skala VM.
Jenis: | String |
Position: | Named |
nilai default: | None |
Diperlukan: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
Menunjukkan apa yang akan terjadi jika cmdlet berjalan. Cmdlet tidak dijalankan.
Jenis: | SwitchParameter |
Aliases: | wi |
Position: | Named |
nilai default: | None |
Diperlukan: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |