AIPService PowerShell modülünü yükleme
Azure Information Protection'dan koruma hizmeti için Windows PowerShell modülünü yüklemenize yardımcı olması için aşağıdaki bilgileri kullanın. Bu modülün adı AIPService'tir ve AADRM adlı önceki sürümün yerini alır.
Bu PowerShell modülünü, internet bağlantısı olan ve sonraki bölümde listelenen önkoşulları karşılayan herhangi bir Windows bilgisayarı kullanarak komut satırından koruma hizmetini (Azure Rights Management) yönetmek için kullanabilirsiniz. Azure Information Protection için Windows PowerShell, otomasyon için betik oluşturma işlemini destekler veya gelişmiş yapılandırma senaryoları için gerekli olabilir. Modülün desteklediği yönetim görevleri ve yapılandırmaları hakkında daha fazla bilgi için bkz. PowerShell kullanarak Azure Information Protection'dan korumayı Yönetici.
Önkoşullar
Bu tabloda, Azure Information Protection'dan koruma hizmeti için AIPService PowerShell modülünü yükleme ve kullanma önkoşulları listelenir.
| Gereksinim | Daha fazla bilgi |
|---|---|
| Windows PowerShell'in en düşük sürümü | Sürüm 3.0 PowerShell oturumuna yazarak $PSVersionTable çalıştırdığınız Windows PowerShell sürümünü onaylayabilirsiniz. Windows PowerShell'in daha yeni bir sürümünü yüklemeniz gerekirse bkz. Mevcut Windows PowerShell sürümünü yükseltme. AIPService PowerShell modülünün yalnızca Windows PowerShell'i desteklediğini unutmayın. PowerShell 7 desteklenmez. |
| Microsoft .NET Framework'ün en düşük sürümü | Sürüm 4.8 Not: Microsoft .NET Framework'ün bu sürümü sonraki işletim sistemlerine eklenmiştir, bu nedenle yalnızca istemci işletim sisteminiz Windows 8.0'dan küçükse veya sunucu işletim sisteminiz Windows Server 2012'den küçükse el ile yüklemeniz gerekir. Microsoft .NET Framework'ün en düşük sürümü zaten yüklü değilse, Microsoft .NET Framework 4.8'i indirebilirsiniz. Microsoft .NET Framework'ün bu en düşük sürümü, AIPService modülünün kullandığı bazı sınıflar için gereklidir. |
| Gerekli lisans | Bu özelliği kullanmak için bir ürün lisansına sahip olmanız gerekir. Daha fazla bilgi için bkz . Güvenlik ve uyumluluk için Microsoft 365 lisanslama kılavuzu - Hizmet Açıklamaları. |
AADRM modülü yüklüyse
AIPService modülü, eski AADRM modülünün yerini alır. Eski modülü yüklediyseniz, modülü kaldırın ve ardından AIPService modülünü yükleyin.
Daha yeni modülün, mevcut betiklerin çalışmaya devam etmesi için eski modüldeki cmdlet adlarının diğer adları vardır. Ancak, eski modül destekten çıkmadan önce bu başvuruları güncelleştirmeyi planlayın. AADRM modülü desteği 15 Temmuz 2020'de sona erecektir.
AADRM modülünü PowerShell Galerisi yüklediyseniz, kaldırmak için Yönetici istrator olarak çalıştır seçeneğiyle bir PowerShell oturumu başlatın ve şunu yazın:
Uninstall-Module -Name AADRM
AADRM modülünü Azure Rights Management Yönetici istration Tool ile yüklediyseniz, Windows Azure AD Rights Management Yönetici istration'ı kaldırmak için Programlar ve Özellikler'i kullanın.
AIPService modülünü yükleme
AIPService modülü PowerShell Galerisi üzerindedir ve Microsoft İndirme Merkezi'nden kullanılamaz.
AIPService modülünü PowerShell Galerisi yüklemek için
PowerShell Galerisi yeniyseniz bkz. PowerShell Galerisi kullanmaya başlama. PowerShellGet modülünü ve NuGet sağlayıcısını yüklemeyi de içeren galeri gereksinimleri yönergelerini izleyin.
PowerShell Galerisi AIPService modülü hakkındaki ayrıntıları görmek için AIPService sayfasını ziyaret edin.
AIPService modülünü yüklemek için, Yönetici istrator olarak çalıştır seçeneğiyle bir PowerShell oturumu başlatın ve şunu yazın:
Install-Module -Name AIPService
Güvenilmeyen bir depodan yükleme hakkında uyarılırsanız onaylamak için Y tuşuna basabilirsiniz. Alternatif olarak, N tuşuna basın ve komutunu Set-PSRepository -Name PSGallery -InstallationPolicy Trusted kullanarak PowerShell Galerisi güvenilir bir depo olarak yapılandırın ve ardından komutu yeniden çalıştırarak AIPService modülünü yükleyin.
Galeri'den AIPService modülünün önceki bir sürümü yüklüyse, şunu yazarak en son sürüme güncelleştirin:
Update-Module -Name AIPService
Sonraki adımlar
Windows PowerShell oturumunda, yüklü modülün sürümünü onaylayın. Bu denetim özellikle eski bir sürümden yükselttiyseniz önemlidir:
(Get-Module AIPService –ListAvailable).Version
Dekont
Bu komut başarısız olursa, önce Import-Module AIPService komutunu çalıştırın.
Hangi cmdlet'lerin kullanılabilir olduğunu görmek için aşağıdakileri yazın:
Get-Command -Module AIPService
Get-Help <cmdlet_name> Belirli bir cmdlet'in Yardım'ını görmek için komutunu ve Microsoft belgeleri sitesindeki en son yardımı görmek için -online parametresini kullanın. Örneğin:
Get-Help Connect-AipService -online
Daha fazla bilgi için:
Kullanılabilir cmdlet'lerin tam listesi: AIPService Modülü
PowerShell'i destekleyen ana yapılandırma senaryolarının listesi: PowerShell kullanarak Azure Information Protection'dan korumayı Yönetici
Koruma hizmetini yapılandıran komutları çalıştırabilmeniz için önce Bağlan-AipService cmdlet'ini kullanarak hizmete bağlanmanız gerekir.
Yapılandırma komutlarınızı çalıştırmayı bitirdiğinizde, en iyi yöntem olarak Disconnect-AipService cmdlet'ini kullanarak hizmet bağlantısını kesin. Bağlantıyı kesmezseniz, işlem yapılmayan bir süre sonra bağlantı otomatik olarak kesilir. Otomatik bağlantı kesme davranışı nedeniyle, bir PowerShell oturumunda ara sıra yeniden bağlanmanız gerektiğini fark edebilirsiniz.
Dekont
Koruma hizmeti henüz etkinleştirilmemişse, enable-AipService cmdlet'ini kullanarak hizmete bağlandıktan sonra bunu yapabilirsiniz.