Adaptasi Windows

Ringkasan

Untuk sistem Windows, Google Cloud Migrate for Compute Engine (sebelumnya Velostrata) menyediakan beberapa skrip adaptasi OS secara default. Anda juga dapat memberikan skrip tambahan dengan menyimpannya ke direktori ini:

c:\Program Files\Velostrata\UserScripts

Registry diupdate untuk menjalankan skrip (juga dikenal sebagai UserTasks) saat perangkat dinyalakan, bergantung pada lingkungan tempat VM berjalan (juga dikenal sebagai MachineState).

Tiga opsi untuk MachineState adalah:

• Origin - Skrip dijalankan saat VM berada di lingkungan lokal
• Velostrata - Skrip dijalankan saat VM berjalan dalam mode cache.
• Detach - Skrip dijalankan setelah operasi pelepasan.

Tugas dijalankan secara berurutan dalam urutan abjad. Jika urutan tugas penting, gunakan awalan numerik dalam nama tugas, seperti 10_ResetWMI dan 20_ConfigKMS. Pastikan untuk menggunakan jalur absolut dalam skrip pengguna karena jalur relatif tidak akan di-resolve dengan benar.

Penting: Agar tugas dapat dikonfigurasi dengan benar, skrip harus disimpan di direktori UserScripts dan kunci registry harus diperbarui. Bagian berikut menjelaskan cara melakukannya dengan mudah menggunakan skrip bantuan. Perlu diperhatikan bahwa hanya skrip PowerShell yang dapat digunakan untuk tujuan ini.

Skrip Bantuan PowerShell

Migrate for Compute Engine menyediakan modul PowerShell yang menyederhanakan penginstalan skrip pengguna Anda di VM yang relevan. Skrip ini memvalidasi input pengguna untuk mencegah status yang tidak konsisten, menyalin skrip pengguna ke direktori UserScripts, dan membuat hierarki jika diperlukan. Modul PowerShell juga membuat kunci registry yang relevan beserta hierarkinya, serta mengisi nilai yang sesuai.

Nama modul: VelostrataUserScripts.psm1

Perintah yang tersedia adalah: Install-VelosUserScript dan Remove-VelosUserScript

Untuk menggunakan skrip bantuan:

1. Instal modul.
2. Download Skrip Pengguna PowerShell dari halaman Download.

3. Impor modul (gunakan jalur yang benar untuk deployment Anda):

   Import-Module .\VelostrataUserScripts.psm1 -force

4. Jalankan skrip bantuan untuk setiap skrip/tugas adaptasi OS yang ingin Anda konfigurasi. Contoh:
   

   Install-VelosUserScript -FilePath .\resetWMI.ps1 -TaskName "10_ResetWMI" -MachineState Detach -TaskType RunAlways -Platform GCP 

   dengan:

   • FilePath adalah nama file dan jalur skrip, dan dapat berupa jalur relatif atau absolut.

     Catatan: Skrip ini berada di direktori UserScripts Velostrata. Jika skrip bergantung pada file lain, pastikan jalur ke file tersebut absolut, atau salin file dependen ke direktori skrip pengguna.

   • TaskName adalah nama unik yang ingin Anda gunakan untuk tugas. Lihat catatan tentang pengurutan di atas.

   • MachineState adalah salah satu dari tiga opsi berikut:

     • Origin - lingkungan lokal.
     • Migrate for Compute Engine - Skrip akan berjalan saat VM berjalan dalam mode cache.
     • Detach - Skrip akan berjalan setelah operasi pelepasan.

   • TaskType adalah salah satu dari opsi berikut:

     • RunOnce - Ini berarti tugas akan berjalan sekali pada booting berikutnya, lalu dihapus.
     • RunAlways - Tugas berjalan pada setiap booting.

   • Platform adalah salah satu lingkungan berikut tempat VM berjalan:

     • Aws
     • All
     Catatan: Parameter Platform bersifat opsional dan defaultnya adalah All.

5. Perintah penghapusan skrip memvalidasi bahwa ada tugas, lalu menghapusnya dari registry, dan secara opsional dari direktori skrip.

   Remove-VelosUserScript -TaskName "ResetWMI" -MachineState Detach -DeleteScriptFile

   dengan:

   • TaskName mirip dengan yang disediakan selama scriptInstall.
   • DeleteScriptFile adalah parameter opsional. Contoh:

     Install-VelosUserScript -FilePath .\KMS\Config-Kms_AWS.ps1 -TaskName "10_configKMS" -MachineState Velostrata -TaskType RunAlways

     Remove-VelosUserScript -TaskName "10_configKMS" -MachineState Velostrata -DeleteScriptFile