AIPService PowerShell modülünü yükleme

Uygulama hedefi: Azure Information Protection, Office 365

İlgili: AIP birleştirilmiş etiketleme istemcisi ve klasik istemci

Not

Birleşik ve kolaylaştırılmış bir müşteri deneyimi sağlamak için Azure portalındaki Azure Information Protection Klasik istemci ve etiket yönetimi 31 Mart 2021 itibarıyla kullanım dışıdır . Klasik istemci yapılandırıldığı şekilde çalışmaya devam ederken, başka bir destek sağlanmaz ve artık klasik istemci için bakım sürümleri yayınlanmayacaktır.

Birleşik etiketlemeye geçiş yapmanızı ve Birleşik etiketleme istemcisineyükseltmenizi öneririz. Son kullanımdan kaldırma blogumuzhakkında daha fazla bilgi edinin.

Azure Information Protection 'den 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ı Aıpservice ' dir 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 betikleri destekler veya gelişmiş yapılandırma senaryolarında gerekli olabilir. Modülün desteklediği yönetim görevleri ve yapılandırma hakkında daha fazla bilgi için bkz. PowerShell kullanarak Azure Information Protection koruma yönetimi.

Önkoşullar

Bu tabloda, Azure Information Protection 'den koruma hizmeti için Aıpservice PowerShell modülünü yüklemek ve kullanmak üzere önkoşulları listelenir.

Gereksinim Daha fazla bilgi
En düşük Windows PowerShell sürümü Sürüm 3,0

Çalıştırmakta olduğunuz Windows PowerShell sürümünü $PSVersionTable bir PowerShell oturumunda yazarak doğrulayabilirsiniz. Windows PowerShell'in daha yeni bir sürümünü yüklemeniz gerekirse bkz. Mevcut Windows PowerShell sürümünü yükseltme.
Microsoft .NET Framework 'ün en düşük sürümü Sürüm 4,5

Note: Microsoft .NET Framework 'ün bu sürümü sonraki işletim sistemlerine dahil edilmiştir. bu nedenle, yalnızca istemci Işletim sisteminiz Windows 8,0 ' den az veya sunucu Işletim sisteminiz windows Server 2012 ' den az olduğunda el ile yüklemeniz gerekir.

Microsoft .NET Framework 'ün en düşük sürümü zaten yüklü değilse, Microsoft .NET framework 4,5' i indirebilirsiniz. Aıpservice modülünün kullandığı sınıfların bazıları için Microsoft .NET Framework 'ün en düşük sürümü gerekir.
Gerekli lisans Premium veya Enterprise lisansı

AADRM modülü yüklüyse

AIPService modülü eski modülün (AADRM) yerini alır. Eski modül yüklüyse, kaldırın ve ardından Aıpservice modülünü yükleme.

Yeni modülün, eski modüldeki cmdlet adlarına diğer adları vardır, böylece mevcut betikler çalışmaya devam edecektir. Ancak, eski modülün destek dışı bırakmadan önce bu başvuruları güncelleştirmeyi planlayın. AADRM modülünün desteği 15 Temmuz 2020 tarihinde sona acaktır.

AADRM modülünü PowerShell Galerisi yüklediyseniz, kaldırmak için yönetici 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önetim aracı ile yüklediyseniz, Windows Azure AD Rights Management yönetimini kaldırmak için Programlar ve Özellikler ' i kullanın.

Aıpservice modülünü yüklemek

Aıpservice modülü PowerShell Galerisi ve Microsoft İndirme Merkezi ' nden kullanılamaz.

PowerShell Galerisi yeni başladıysanız, bkz. PowerShell Galerisi kullanmaya başlama. PowerShellGet modülünü ve NuGet sağlayıcısını yüklemeyi kapsayan Galeri gereksinimleriyle ilgili yönergeleri izleyin.

PowerShell Galerisi Aıpservice modülüyle ilgili ayrıntıları görmek için aıpservice sayfasınıziyaret edin.

Aıpservice modülünü yüklemek için, yönetici 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ı alırsanız, onaylamak için Y tuşuna basın. Ya da, komutunu kullanarak PowerShell Galerisi güvenilir bir depo olarak yapılandırın ve Set-PSRepository -Name PSGallery -InstallationPolicy Trusted ardından Aıpservice modülünü yüklemek için komutu yeniden çalıştırın.

Galeriden Aıpservice modülünün önceki bir sürümüne sahipseniz, şunu yazarak güncelleştirmeyi en son sürüme güncelleştirin:

Update-Module -Name AIPService

Sonraki adımlar

Bir Windows PowerShell oturumunda, yüklü modülün sürümünü onaylayın. Bu denetim, özellikle de eski bir sürümden yükselttiyseniz önemlidir:

(Get-Module AIPService –ListAvailable).Version

Not

Bu komut başarısız olursa, önce Import-Module Aıpservice komutunu çalıştırın.

Hangi cmdlet'lerin kullanılabilir olduğunu görmek için şunu yazın:

Get-Command -Module AIPService

Belirli bir cmdlet’e yönelik Yardım menüsünü görmek için Get-Help <cmdlet_name> komutunu; Microsoft belgeleri sitesindeki en son yardım konularını görmek içinse -online parametresini kullanın. Örneğin:

Get-Help Connect-AipService -online

Daha fazla bilgi için:

Koruma hizmetini yapılandıran herhangi bir komutu çalıştırmadan önce, Connect-Aıpservice cmdlet 'ini kullanarak hizmete bağlanmanız gerekir.

Yapılandırma komutlarınızı çalıştırmayı tamamladığınızda, en iyi uygulama olarak, Disconnect-Aıpservice cmdlet 'ini kullanarak hizmetten bağlantıyı kesin. Bağlantıyı kesmezseniz bağlantı bir süre işlem yapılmadığında otomatik olarak kesilir. Otomatik bağlantı kesme davranışı nedeniyle bir PowerShell oturumu sırasında zaman zaman yeniden bağlanmanız gerekebilir.

Not

Koruma hizmeti henüz etkinleştirilmemişse, Enable-Aıpservice cmdlet 'ini kullanarak hizmeti bağladıktan sonra bunu yapabilirsiniz.