Menginstal Modul PowerShell Exchange Online (Langkah demi Langkah)

By Mirko Peters · 2026-11-12

Instal modul PowerShell Exchange Online dengan Install-Module ExchangeOnlineManagement: persyaratan, cakupan, pemeriksaan versi, pembaruan, dan cara memperbaiki error.

Automatically translated with AI from the original post. Read the English original

Untuk menginstal modul PowerShell Exchange Online, buka PowerShell sebagai administrator dan jalankan Install-Module -Name ExchangeOnlineManagement. Perintah itu menginstal modul bagi semua pengguna di komputer. Jika Anda tidak dapat menjalankannya sebagai administrator, tambahkan -Scope CurrentUser dan modul akan diinstal hanya untuk akun Anda sendiri. Artikel ini ditujukan bagi admin Exchange dan Microsoft 365 yang menyiapkan PC admin baru, jump server, atau build agent. Artikel ini membahas persyaratan, langkah instalasi dan verifikasi, pembaruan serta penghapusan modul, dan error yang paling sering dialami.

Poin Penting

• Instal modul PowerShell Exchange Online dengan Install-Module -Name ExchangeOnlineManagement, di jendela PowerShell yang dijalankan sebagai administrator untuk semua pengguna.
• Gunakan -Scope CurrentUser jika Anda tidak dapat menggunakan hak administrator. Perbarui modul nanti dengan cakupan yang sama dengan saat Anda menginstalnya.
• Windows PowerShell 5.1 memerlukan .NET Framework 4.7.2. Dukungan PowerShell 7 bergantung pada versi modul, dan versi 3.10.0 atau yang lebih baru memerlukan PowerShell 7.6.0.
• Periksa hasilnya dengan Get-InstalledModule, yang menampilkan versi dan apakah modul berada di lokasi untuk semua pengguna atau pengguna saat ini.
• Modul ini tidak lagi memerlukan autentikasi Basic di WinRM, karena koneksinya menggunakan REST.

Apa itu modul ini dan apa yang perlu disiapkan terlebih dahulu

Modul ini bernama ExchangeOnlineManagement. Dokumentasi Microsoft menyebutnya modul Exchange Online PowerShell V3. Modul ini menghubungkan Anda ke Exchange Online PowerShell, ke Security & Compliance PowerShell, dan ke PowerShell untuk add-on keamanan bawaan bagi kotak surat lokal. Modul ini menggunakan modern authentication, sehingga berfungsi dengan atau tanpa autentikasi multifaktor.

Satu perubahan memengaruhi skrip lama. Microsoft menyatakan bahwa sejak Oktober 2023, koneksi REST API telah menggantikan koneksi remote PowerShell lama yang menggunakan autentikasi Basic. Koneksi modul ini tidak memerlukan autentikasi Basic di WinRM, sehingga tidak ada yang perlu diaktifkan di sana.

Sebelum menginstal, periksa prasyarat berikut:

• Versi PowerShell dan .NET. Windows PowerShell 5.1 memerlukan .NET Framework 4.7.2. Windows 11, Windows Server 2022, dan Windows Server 2025 sudah dilengkapi 4.8.x, jadi kebutuhan tersebut sudah terpenuhi. PowerShell 7 juga didukung, dan versi minimumnya bergantung pada versi modul, yang dijelaskan di bagian berikutnya.
• Kebijakan eksekusi. Halaman Microsoft menyebutkan bahwa tanpa kebijakan eksekusi yang sesuai, Anda akan menerima error "Files cannot be loaded because running scripts is disabled on this system". Perbaikan yang didokumentasikan adalah Set-ExecutionPolicy RemoteSigned, yang dijalankan sebagai administrator. Baca halaman Microsoft tentang kebijakan eksekusi sebelum Anda mengubahnya, dan tanyakan dahulu kepada tim keamanan Anda jika mesin tersebut dikelola.
• PowerShellGet dan PackageManagement. Koneksi REST di Windows memerlukan PowerShellGet, dan PowerShellGet bergantung pada PackageManagement. Tanpa keduanya, Anda mungkin melihat galat tentang cmdlet Update-ModuleManifest yang tidak ditemukan. Microsoft juga menyatakan bahwa versi preview dari kedua modul ini dapat menyebabkan masalah koneksi, dan memberikan perintah untuk mencantumkan versi yang terpasang: Get-InstalledModule PackageManagement -AllVersions; Get-InstalledModule PowerShellGet -AllVersions.
• TLS 1.2. Pada Windows PowerShell 5.1 dengan Windows versi lama, PowerShell Gallery memerlukan TLS 1.2 atau yang lebih baru. Jika unduhan gagal dengan galat koneksi di server lama, ini adalah hal pertama yang perlu diperiksa.

Sistem yang sangat lama tidak bisa diandalkan. Windows 7 SP1 dan Windows Server 2008 R2 SP1 hanya mendapatkan modul versi 2.0.3, dan Microsoft menyatakan bahwa versi tersebut tidak dapat terhubung karena tidak memiliki dukungan REST.

Versi PowerShell mana yang cocok dengan versi modul

Windows PowerShell 5.1 bekerja dengan semua versi modul, dengan syarat .NET seperti yang disebutkan di atas. Untuk PowerShell 7, Microsoft mencantumkan pemetaan berikut:

• Modul 3.10.0 atau yang lebih baru memerlukan PowerShell 7.6.0 atau yang lebih baru, yang menggunakan .NET 10.
• Modul 3.5.0 hingga 3.9.2 memerlukan PowerShell 7.4.0 atau yang lebih baru, yang menggunakan .NET 8.
• Modul 3.0.0 hingga 3.4.0 memerlukan PowerShell 7.2.0 atau yang lebih baru, yang menggunakan .NET 6.
• Modul 2.0.4 dan versi 2.x yang lebih baru memerlukan PowerShell 7.0.3.

Jadi, jika Anda memasang modul terbaru di komputer dengan PowerShell 7.4, bersiaplah menghadapi masalah. Anda bisa memperbarui PowerShell, atau memasang versi modul yang lebih lama dengan -RequiredVersion. Saat artikel ini ditulis, Microsoft mencantumkan 3.10.1 sebagai versi terkini. Periksa halaman modul untuk nomor versi yang berlaku saat Anda membaca ini.

Microsoft juga mendukung modul ini di Linux dan macOS. Di Linux, koneksi melalui proxy memerlukan modul versi 3.0.0 atau yang lebih baru. Di kedua sistem tersebut, Connect-IPPSSession, dan dengannya Security & Compliance PowerShell, tidak tersedia di PowerShell 7. Jika Anda mengelola Exchange Online dari Mac, itulah satu-satunya batasan yang perlu diketahui sebelum Anda merencanakan perangkat pendukung Anda.

Windows 10 layak mendapat catatan singkat. Edisi konsumen telah mencapai akhir dukungan pada Oktober 2025, dan Microsoft menyatakan bahwa edisi tersebut tidak mendukung .NET 8.0 atau .NET 10.0. Untuk modul 3.5.0 dan yang lebih baru dengan PowerShell 7.4 atau yang lebih baru, hanya edisi Enterprise dan IoT LTSC yang masih didukung yang dapat berfungsi.

Periksa versi PowerShell Anda sebelum memasang

Pemeriksaan dua menit menghemat banyak tebak-tebakan nanti. Di jendela tempat Anda akan bekerja, jalankan $PSVersionTable.PSVersion untuk melihat versi PowerShell yang Anda gunakan. Bandingkan hasilnya dengan pemetaan di atas. Pada Windows PowerShell 5.1, Anda juga perlu mengetahui versi PowerShellGet, jadi jalankan Get-InstalledModule PowerShellGet -AllVersions. Jika perintah tersebut mencantumkan versi preview, hapus atau perbarui ke rilis stabil sebelum melanjutkan. Halaman modul Microsoft menyebut build preview PowerShellGet dan PackageManagement sebagai sumber masalah koneksi.

Catat hasilnya di samping nama mesin jika Anda mengelola lebih dari beberapa server. Ketika rekan kerja melaporkan koneksi yang gagal tiga bulan kemudian, Anda bisa membandingkan versi dalam hitungan detik.

Cara memasang modul PowerShell Exchange Online langkah demi langkah

Langkah-langkah ini berfungsi di Windows PowerShell 5.1 maupun PowerShell 7.

1. Buka PowerShell. Pilih Run as administrator jika Anda ingin memasang untuk semua pengguna. Lewati langkah ini jika Anda hanya ingin memasang untuk pengguna saat ini.
2. Jika ini adalah modul pertama yang Anda pasang di komputer tersebut, perbarui PowerShellGet terlebih dahulu, lalu tutup dan buka kembali PowerShell. Microsoft merekomendasikan urutan ini sebelum pemasangan pertama.
3. Jalankan Install-Module -Name ExchangeOnlineManagement untuk semua pengguna. Untuk akun Anda sendiri saja, jalankan Install-Module -Name ExchangeOnlineManagement -Scope CurrentUser.
4. Jawab setiap perintah yang ditampilkan PowerShell selama pemasangan. Organisasi Anda harus mengizinkan akses ke PowerShell Gallery agar unduhan berhasil.
5. Verifikasi pemasangan dengan Get-InstalledModule ExchangeOnlineManagement | Format-List Name,Version,InstalledLocation.
6. Lihat baris InstalledLocation. Jalur di bawah %ProgramFiles%\WindowsPowerShell\Modules\ berarti modul terpasang untuk semua pengguna. Jalur di folder Documents Anda berarti modul hanya terpasang untuk pengguna saat ini.
7. Uji coba di jendela baru dengan Connect-ExchangeOnline -UserPrincipalName admin@contoso.com. Untuk detail koneksi, lihat artikel Connect to Exchange Online PowerShell.

Ingin menggunakan build pratinjau? Tambahkan -AllowPrerelease. Untuk memilih versi pratinjau tertentu, gabungkan dengan -RequiredVersion. Find-Module ExchangeOnlineManagement -AllVersions -AllowPrerelease menampilkan semua versi yang tersedia, sedangkan jika -AllowPrerelease dihilangkan, hanya versi publik yang ditampilkan. Jangan pasang build pratinjau di server admin produksi kecuali ada alasan yang jelas. Uji dulu di mesin cadangan.

Memperbarui dan menghapus modul

Microsoft secara rutin merilis versi modul baru, dan catatan rilis di halaman modulnya menunjukkan apa saja yang berubah. Versi 3.7.0, misalnya, berhenti memuat bantuan baris perintah secara default, dan versi 3.9.2 menghentikan dukungan parameter UseRpsSession. Pembaruan cukup dengan satu baris perintah: Update-Module -Name ExchangeOnlineManagement. Untuk instalasi current-user, tambahkan -Scope CurrentUser. Microsoft menyarankan agar Anda menggunakan cakupan (scope) yang sama dengan saat instalasi. Ketidaksesuaian dapat membuat modul terpasang di dua lokasi dan membuat Anda tidak tahu pasti versi mana yang digunakan PowerShell.

Itulah alasan mengapa pemeriksaan Get-InstalledModule di langkah 5 layak dijalankan sebelum dan sesudah pembaruan. Jika Anda melihat dua versi, cari tahu cakupan masing-masing versi tersebut.

Untuk menghapus modul, jalankan Uninstall-Module -Name ExchangeOnlineManagement. Jika modul dipasang untuk semua pengguna, lakukan sebagai administrator. Setelah itu, tutup jendela PowerShell yang masih terbuka, karena modul yang sudah dimuat tetap berada di memori hingga sesinya berakhir.

Mengatasi kesalahan instalasi yang umum

Halaman modul Microsoft mencantumkan beberapa kesalahan spesifik beserta solusinya.

• "No match was found for the specified search criteria and module name 'ExchangeOnlineManagement'". Jalankan Register-PSRepository -Default untuk mendaftarkan kembali PowerShell Gallery sebagai repositori. Setelah itu, coba instalasi lagi.
• Kesalahan terkait PowerShellGetFormatVersion, atau tidak dapat mengunduh provider. Perbarui PowerShellGet lalu mulai ulang PowerShell.
• Unduhan gagal di mesin Windows PowerShell 5.1 yang lebih lama. PowerShell Gallery membutuhkan TLS 1.2 atau yang lebih baru. Microsoft menautkan sebuah postingan blog tentang dukungan TLS di gallery tersebut untuk detailnya.
• "Files cannot be loaded because running scripts is disabled on this system". Atur execution policy seperti yang dijelaskan di atas, sebagai administrator.
• "Cannot find a cmdlet Update-Manifest" atau pesan serupa tentang Update-ModuleManifest saat Anda terhubung. PowerShellGet atau PackageManagement tidak tersedia. Pasang keduanya lalu mulai ulang PowerShell.

Jika instalasi berhasil tetapi koneksi kemudian gagal dengan kesalahan assembly yang aneh, penyebabnya biasanya adalah modul lain dalam sesi yang sama. Buka jendela baru dan hubungkan terlebih dahulu.

Kesalahan umum

• Mencampur cakupan. Memasang untuk semua pengguna lalu memperbarui dengan -Scope CurrentUser akan meninggalkan dua versi di mesin yang sama. Pilih satu cakupan dan tetap gunakan.
• Menjalankan versi PowerShell yang keliru untuk modul. Modul terbaru dengan PowerShell 7 yang lebih lama akan gagal dengan cara yang tampak seperti kesalahan koneksi. Bandingkan versi Anda dengan tabel di atas.
• Memasang versi pratinjau di host produksi. Versi pratinjau ditujukan untuk pengujian. Gunakan versi publik untuk pekerjaan harian.
• Mengabaikan PowerShellGet. PowerShellGet yang tidak ada atau berupa versi pratinjau dapat merusak koneksi REST, sebagaimana dijelaskan di halaman Microsoft. Periksa itu terlebih dahulu saat instalasi baru tidak dapat terhubung.
• Mengikuti tutorial lama. Panduan yang meminta Anda mengaktifkan autentikasi Basic di WinRM menjelaskan metode remote PowerShell yang sudah dihentikan. Anda tidak memerlukannya.

Topik terkait untuk dijelajahi

• Terhubung dengan modul: setelah modul terpasang, pertanyaan berikutnya adalah cara masuk, dengan atau tanpa MFA. Hal ini dibahas dalam artikel tentang modul Exchange Online PowerShell beserta artikel pendampingnya tentang koneksi.
• Autentikasi app-only: skrip terjadwal memerlukan sertifikat atau managed identity, bukan kata sandi yang diketik.
• Menggunakan modul di PowerShell 7 pada Linux dan macOS: versi yang didukung berbeda untuk setiap sistem operasi, jadi periksa daftar kompatibilitas terlebih dahulu.
• Mengontrol siapa yang dapat menggunakan PowerShell: admin Exchange dapat mengaktifkan atau menonaktifkan akses ke Exchange Online PowerShell untuk setiap pengguna.
• Menjaga modul tetap mutakhir: atur pengingat rutin untuk memeriksa versi modul baru, karena Microsoft sesekali menaikkan versi PowerShell minimum.

Langkah berikutnya

Untuk menginstal modul Exchange Online PowerShell, jalankan Install-Module -Name ExchangeOnlineManagement, verifikasi dengan Get-InstalledModule, dan pertahankan cakupan (scope) yang sama untuk setiap pembaruan berikutnya. Setelah itu, hubungkan dengan Connect-ExchangeOnline di jendela baru, lalu jalankan Get-AcceptedDomain untuk memastikan pengaturannya berfungsi.