Cara memasang agen Connected Machine menggunakan Windows PowerShell DSC

Menggunakan Windows PowerShell Desired State Configuration (DSC), Anda dapat mengotomatiskan penginstalan dan konfigurasi perangkat lunak untuk komputer Windows. Artikel ini menjelaskan cara menggunakan DSC untuk menginstal agen Azure Connected Machine pada komputer Windows hibrid.

Persyaratan

Memasang modul DSC ConnectedMachine

  1. Untuk memasang modul secara manual, unduh kode sumber dan unzip konten direktori proyek ke $env:ProgramFiles\WindowsPowerShell\Modules folder. Jika tidak, jalankan perintah berikut ini untuk memasang dari galeri PowerShell menggunakan PowerShellGet (di PowerShell 5.0):

    Find-Module -Name AzureConnectedMachineDsc -Repository PSGallery | Install-Module
    
  2. Untuk mengonfirmasi penginstalan, jalankan perintah berikut dan pastikan Anda melihat sumber daya DSC Azure Connected Machine tersedia.

    Get-DscResource -Module AzureConnectedMachineDsc
    

    Pada output, Anda akan melihat sesuatu yang mirip dengan hal berikut:

    Confirmation of Connected Machine DSC module installation example

Memasang agen dan menyambungkan ke Azure

Sumber daya dalam modul ini dirancang untuk mengelola konfigurasi agen Azure Connected Machine. Juga termasuk skrip AzureConnectedMachineAgent.ps1 PowerShell, yang ditemukan di folder AzureConnectedMachineDsc\examples. Skrip ini menggunakan sumber daya komunitas untuk mengotomatiskan unduhan dan penginstalan, dan membangun koneksi dengan Azure Arc. Skrip ini melakukan langkah serupa yang dijelaskan dalam artikel Menyambungkan komputer hibrida ke Azure dari portal Microsoft Azure.

Jika komputer perlu berkomunikasi melalui server proksi ke layanan, setelah Anda memasang agen, Anda perlu menjalankan perintah yang dijelaskan dalam langkah-langkah di sini. Perintah ini mengatur variabel lingkungan sistem server proksi https_proxy. Alih-alih menjalankan perintah secara manual, Anda dapat melakukan langkah ini dengan DSC dengan menggunakan modul ComputeManagementDsc. Dengan menggunakan konfigurasi ini, agen berkomunikasi melalui server proksi menggunakan protokol HTTP.

Catatan

Untuk memungkinkan DSC berjalan, Windows perlu dikonfigurasi untuk menerima perintah jarak jauh PowerShell bahkan ketika Anda menjalankan konfigurasi localhost. Untuk mengonfigurasi lingkungan Anda dengan mudah, cukup jalankan Set-WsManQuickConfig -Force di Terminal PowerShell yang ditingkatkan.

Dokumen konfigurasi (file MOF) dapat diterapkan ke komputer menggunakan cmdlet Start-DscConfiguration.

Berikut ini adalah parameter yang Anda berikan ke skrip PowerShell untuk digunakan.

  • TenantId: Pengidentifikasi unik (GUID) yang mewakili instans khusus Azure Active Directory Anda.

  • SubscriptionId: ID langganan (GUID) dari langganan Azure yang untuk komputer yang Anda inginkan.

  • ResourceGroup: Nama grup sumber daya yang mencakup komputer yang terhubung milik Anda.

  • Location: Lihat wilayah Azure yang didukung. Lokasi ini dapat sama atau berbeda dengan lokasi grup sumber daya.

  • Tags: Array tag string yang harus diterapkan ke sumber daya komputer yang terhubung.

  • Credential: Objek info masuk PowerShell dengan ApplicationId dan kata sandi yang digunakan untuk mendaftarkan komputer dalam skala besar menggunakan perwakilan layanan.

  1. Di konsol PowerShell, buka folder tempat Anda menyimpan file .ps1.

  2. Jalankan perintah PowerShell berikut untuk mengompilasi dokumen MOF (untuk informasi tentang cara mengompilasi konfigurasi DSC, lihat Konfigurasi DSC:

    .\`AzureConnectedMachineAgent.ps1 -TenantId <TenantId GUID> -SubscriptionId <SubscriptionId GUID> -ResourceGroup '<ResourceGroupName>' -Location '<LocationName>' -Tags '<Tag>' -Credential <psCredential>
    
  3. Tindakan ini akan membuat localhost.mof file dalam folder baru bernama C:\dsc.

Setelah Anda memasang agen dan mengonfigurasinya untuk tersambung ke server dengan dukungan Azure Arc, buka portal Microsoft Azure untuk memverifikasi bahwa server telah berhasil tersambung. Lihat komputer Anda di portal Microsoft Azure.

Menambahkan ke konfigurasi yang sudah ada

Sumber daya ini dapat ditambahkan ke konfigurasi DSC yang ada untuk mewakili konfigurasi menyeluruh untuk komputer. Misalnya, Anda mungkin ingin menambahkan sumber daya ini ke konfigurasi yang menetapkan pengaturan sistem operasi aman.

Modul CompositeResource dari Galeri PowerShell dapat digunakan untuk membuat sumber daya komposit dari konfigurasi sampel untuk menyederhanakan penggabungan konfigurasi lebih lanjut.

Langkah berikutnya