Terhubung ke Exchange Online menggunakan Windows PowerShell
Exchange Online PowerShell adalah modul yang dapat Anda gunakan untuk mengelola objek terkait surat di Exchange Online, seperti kotak surat, kontak, dan distribusi. Beberapa informasi yang dapat Anda tinjau dan kelola menggunakan Exchange Online PowerShell, seperti alamat email, Anda juga dapat meninjau properti objek pengguna dengan cmdlet AzureAD. Namun, Anda hanya dapat mengelola properti terkait surat menggunakan Exchange Online PowerShell.
Catatan
Saat menulis jalur pembelajaran ini, modul Exchange Online PowerShell V2 (EXO v2) adalah versi saat ini. Saat meneliti cara menghubungkan ke Exchange Online, petunjuk yang menunjukkan bahwa Anda perlu menggunakan kontrol jarak jauh PowerShell atau cmdlet Connect-EXOPSSession sudah tidak valid dan tidak boleh diikuti.
Modul EXO v2 mencakup semua cmdlet asli untuk mengelola Exchange Online, dan beberapa cmdlet tambahan yang menyertakan EXO dalam nama cmdlet. EXO ini, seperti Get-EXOMailbox, lebih efisien daripada cmdlet asli.
Menginstal modul EXO v2
Modul EXO v2 didukung di Windows PowerShell 5.1 dan PowerShell 7. Karena didukung di PowerShell 7, modul ini dianggap multiplatform. Anda dapat menggunakan modul EXO v2 di Windows, macOS, dan Linux.
Untuk menginstal modul EXO v2, jalankan perintah berikut:
Install-Module -Name ExchangeOnlineManagement
Bersiap untuk menghubungkan
Untuk menggunakan modul EXO v2, Anda harus mengizinkan skrip. Anda dapat mengatur kebijakan eksekusi ke RemoteSigned atau Unrestricted. Jika Anda tidak mengizinkan skrip, Anda akan melihat kesalahan File tidak dapat dimuat karena menjalankan skrip dinonaktifkan pada sistem ini.
Anda juga perlu mengizinkan autentikasi dasar untuk klien WinRM. Autentikasi ini diaktifkan secara default di Windows 10, tetapi beberapa organisasi telah menonaktifkan autentikasi dasar untuk WinRM sebagai bagian dari peningkatan keamanan. Jika Autentikasi dasar tidak diaktifkan, Anda akan melihat kesalahan Klien WinRM tidak dapat memproses permintaan. Autentikasi dasar saat ini dinonaktifkan dalam konfigurasi klien.
Untuk meninjau konfigurasi autentikasi untuk klien Windows Remote Management (WinRM), jalankan perintah berikut ini:
winrm get winrm/config/client/auth
Untuk mengaktifkan autentikasi dasar untuk klien WinRM, jalankan perintah berikut:
winrm set winrm/config/client/auth '@{Basic="true"}'
Catatan
Jika Anda menjalankan perintah ini dari command prompt, bukan prompt PowerShell, jangan sertakan tanda kutip tunggal di sekeliling @{Basic="true"}.
Meskipun Anda perlu mengaktifkan autentikasi dasar di klien WinRM, modul EXO v2 mengautentikasi ke Exchange Online menggunakan autentikasi Modern. Dalam beberapa kasus yang jarang terjadi, autentikasi Modern mungkin tidak diaktifkan untuk Exchange Online dan Anda harus mengaktifkannya.
Catatan
Semua penyebaran Exchange Online harus menggunakan autentikasi Modern. Ini karena autentikasi modern memiliki peningkatan keamanan yang signifikan jika dibandingkan dengan autentikasi Dasar.
Menghubungkan ke Exchange Online
Anda dapat menghubungkan ke Exchange Online menggunakan cmdlet Connect-ExchangeOnline tanpa parameter tambahan. Saat terhubung ke Exchange Online, Anda diminta memasukkan nama pengguna dan kata sandi untuk masuk. Anda harus masuk dengan akun pengguna yang memiliki hak istimewa yang memadai untuk menyelesaikan tindakan yang ingin Anda lakukan. Anda mungkin juga diminta untuk autentikasi multifaktor.
Catatan
Untuk penyewa di Tiongkok atau Jerman, Anda harus menggunakan parameter -ExchangeEnvironmentName dan menentukan apakah akan menggunakan O365China atau O365Germany. Untuk penyewa pemerintah AS yang aman, Anda harus menentukan O365USGovGCCHigh atau O365USGovDOD.
Jika berada di belakang server proksi, Anda mungkin perlu memberikan opsi proksi sebagai bagian dari upaya menghubungkan. Untuk melakukannya, berikan objek PSSessionOption informasi konfigurasi proksi. Contoh berikut menggambarkan cara membuat objek PSSessionOption baru dan kemudian menggunakannya saat menghubungkan ke Exchange Online:
$ProxyOptions = New-PSSessionOption -ProxyAccessType IEConfig
Connect-ExchangeOnline -PsSessionOption $ProxyOptions