Share via

Menginstal modul AIPService PowerShell

  • Artikel

Gunakan informasi berikut untuk membantu Anda menginstal modul Windows PowerShell untuk layanan perlindungan dari Perlindungan Informasi Azure. Nama modul ini adalah AIPService, dan menggantikan versi sebelumnya yang diberi nama AADRM.

Anda dapat menggunakan modul PowerShell ini untuk mengelola layanan perlindungan (Azure Rights Management) dari baris perintah dengan menggunakan komputer Windows apa pun yang memiliki koneksi internet dan yang memenuhi prasyarat yang tercantum di bagian berikutnya. Windows PowerShell untuk Perlindungan Informasi Azure mendukung pembuatan skrip untuk otomatisasi atau mungkin diperlukan untuk skenario konfigurasi tingkat lanjut. Untuk informasi selengkapnya tentang tugas dan konfigurasi administrasi yang didukung modul, lihat Mengelola perlindungan dari Perlindungan Informasi Azure dengan menggunakan PowerShell.

Prasyarat

Tabel ini mencantumkan prasyarat untuk menginstal dan menggunakan modul AIPService PowerShell untuk layanan perlindungan dari Perlindungan Informasi Azure.

Persyaratan Informasi selengkapnya
Versi minimum Windows PowerShell Versi 3.0

Anda dapat mengonfirmasi versi Windows PowerShell yang Anda jalankan dengan mengetik $PSVersionTable dalam sesi PowerShell. Jika Anda perlu menginstal Windows PowerShell versi yang lebih baru, lihat Memutakhirkan Windows PowerShell yang sudah ada.

Perhatikan modul AIPService PowerShell hanya mendukung Windows PowerShell. PowerShell 7 tidak didukung.
Versi minimum Microsoft .NET Framework Versi 4.8

Catatan: Versi Microsoft .NET Framework ini disertakan dengan sistem operasi yang lebih baru, jadi Anda harus menginstalnya secara manual hanya jika sistem operasi klien Anda kurang dari Windows 8.0 atau sistem operasi server Anda kurang dari Windows Server 2012.

Jika versi minimum Microsoft .NET Framework belum diinstal, Anda dapat mengunduh Microsoft .NET Framework 4.8. Versi minimum Microsoft .NET Framework ini diperlukan untuk beberapa kelas yang digunakan modul AIPService.
Lisensi yang diperlukan Anda harus memiliki lisensi produk untuk menggunakan fitur ini. Untuk informasi selengkapnya, lihat Panduan lisensi Microsoft 365 untuk keamanan & kepatuhan - Deskripsi Layanan.

Jika Anda memiliki modul AADRM yang terinstal

Modul AIPService menggantikan modul lama, AADRM. Jika Anda memiliki modul lama yang terinstal, hapus instalannya lalu instal modul AIPService.

Modul yang lebih baru memiliki alias untuk nama cmdlet dalam modul yang lebih lama sehingga skrip yang ada akan terus berfungsi. Namun, rencanakan untuk memperbarui referensi ini sebelum modul lama tidak didukung. Dukungan untuk modul AADRM akan berakhir 15 Juli 2020.

Jika Anda menginstal modul AADRM dari Galeri PowerShell, untuk menghapus instalannya, mulai sesi PowerShell dengan opsi Jalankan sebagai Administrator , dan ketik:

Uninstall-Module -Name AADRM

Jika Anda menginstal modul AADRM dengan Alat Administrasi Manajemen Hak Azure, gunakan Program dan Fitur untuk menghapus instalasi Administrasi Manajemen Hak Windows Azure AD.

Cara menginstal modul AIPService

Modul AIPService ada di Galeri PowerShell dan tidak tersedia dari Pusat Unduhan Microsoft.

Jika Anda baru menggunakan Galeri PowerShell, lihat Mulai menggunakan Galeri PowerShell. Ikuti instruksi untuk persyaratan galeri, termasuk menginstal modul PowerShellGet dan penyedia NuGet.

Untuk melihat detail tentang modul AIPService di Galeri PowerShell, kunjungi halaman AIPService.

Untuk menginstal modul AIPService, mulai sesi PowerShell dengan opsi Jalankan sebagai Administrator , dan ketik:

Install-Module -Name AIPService

Jika Anda diperingatkan tentang menginstal dari repositori yang tidak tepercaya, Anda dapat menekan Y untuk mengonfirmasi. Atau, tekan N dan konfigurasikan Galeri PowerShell sebagai repositori tepercaya dengan menggunakan perintah Set-PSRepository -Name PSGallery -InstallationPolicy Trusted lalu jalankan ulang perintah untuk menginstal modul AIPService.

Jika Anda memiliki versi modul AIPService sebelumnya yang diinstal dari Galeri, perbarui ke yang terbaru dengan mengetik:

Update-Module -Name AIPService

Langkah berikutnya

Dalam sesi Windows PowerShell, konfirmasikan versi modul yang diinstal. Pemeriksaan ini sangat penting jika Anda meningkatkan dari versi yang lebih lama:

(Get-Module AIPService –ListAvailable).Version

Catatan

Jika perintah ini gagal, pertama-tama jalankan Import-Module AIPService.

Untuk melihat cmdlet mana yang tersedia, ketik yang berikut ini:

Get-Command -Module AIPService

Get-Help <cmdlet_name> Gunakan perintah untuk melihat Bantuan untuk cmdlet tertentu, dan gunakan parameter -online untuk melihat bantuan terbaru di situs dokumentasi Microsoft. Misalnya:

Get-Help Connect-AipService -online

Untuk informasi selengkapnya:

Sebelum dapat menjalankan perintah apa pun yang mengonfigurasi layanan perlindungan, Anda harus tersambung ke layanan dengan menggunakan cmdlet Koneksi-AipService.

Setelah Anda selesai menjalankan perintah konfigurasi, sebagai praktik terbaik, putuskan sambungan dari layanan dengan menggunakan cmdlet Disconnect-AipService . Jika Anda tidak memutuskan sambungan, koneksi akan terputus secara otomatis setelah periode tidak aktif. Karena perilaku pemutusan otomatis, Anda mungkin menemukan bahwa Anda perlu menyambungkan kembali sesekali dalam sesi PowerShell.

Catatan

Jika layanan perlindungan belum diaktifkan, Anda dapat melakukan ini setelah tersambung ke layanan, dengan menggunakan cmdlet Enable-AipService .