AIPService PowerShell modülünü yükleme

  • Makale

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.

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:

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.