AIPService PowerShell modülünü yüklemeInstalling the AIPService PowerShell module

Uygulama hedefi: Azure Information Protection, Office 365Applies to: Azure Information Protection, Office 365

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.Use the following information to help you install the Windows PowerShell module for the protection service from Azure Information Protection. Bu modülün adı Aıpservice ' dir ve AADRM adlı önceki sürümün yerini alır.The name of this module is AIPService, and it replaces the previous version that was named AADRM.

Bu PowerShell modülünü, Internet bağlantısı olan ve sonraki bölümde listelenen önkoşulları karşılayan herhangi bir bilgisayarı kullanarak komut satırından koruma hizmetini (Azure Rights Management) yönetmek için kullanabilirsiniz.You can use this PowerShell module to administer the protection service (Azure Rights Management) from the command line by using any computer that has an Internet connection and that meets the prerequisites listed in the next section. Azure Information Protection için Windows PowerShell, otomasyon için betikleri destekler veya gelişmiş yapılandırma senaryolarında gerekli olabilir.Windows PowerShell for Azure Information Protection supports scripting for automation or might be necessary for advanced configuration scenarios. 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.For more information about the administration tasks and configurations that the module supports, see Administering protection from Azure Information Protection by using PowerShell.

ÖnkoşullarPrerequisites

Bu tabloda, Azure Information Protection 'den koruma hizmeti için Aıpservice PowerShell modülünü yüklemek ve kullanmak üzere önkoşulları listelenir.This table lists the prerequisites to install and use the AIPService PowerShell module for the protection service from Azure Information Protection.

GereksinimRequirement Daha fazla bilgiMore information
Windows PowerShell 'in en düşük sürümü: 3,0Minimum version of Windows PowerShell: 3.0 Çalıştırmakta olduğunuz Windows PowerShell sürümünü bir PowerShell oturumunda yazarak $PSVersionTable doğrulayabilirsiniz.You can confirm the version of Windows PowerShell that you are running by typing $PSVersionTable in a PowerShell session.

Windows PowerShell 'in daha yeni bir sürümünü yüklemeniz gerekiyorsa bkz. var olan Windows PowerShell 'ı yükseltme.If you need to install a later version of Windows PowerShell, see Upgrading existing Windows PowerShell.
Microsoft .NET Framework 'ün en düşük sürümü: 4,5Minimum version of the Microsoft .NET Framework: 4.5

Not: Microsoft .NET Framework 'ün bu sürümü sonraki işletim sistemlerine dahildir. 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.Note: This version of the Microsoft .NET Framework is included with the later operating systems, so you should need to manually install it only if your client operating system is less than Windows 8.0 or your server operating system is less than Windows Server 2012.
Microsoft .NET Framework'ün en düşük sürümü zaten yüklü değilse, Microsoft .NET Framework 4.5 sürümünü indirebilirsiniz.If the minimum version of the Microsoft .NET Framework is not already installed, you can download Microsoft .NET Framework 4.5.

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.This minimum version of the Microsoft .NET Framework is required for some of the classes that the AIPService module uses.

AADRM modülü yüklüyseIf you have the AADRM module installed

AIPService modülü eski modülün (AADRM) yerini alır.The AIPService module replaces the older module, AADRM. Eski modül yüklüyse, kaldırın ve ardından Aıpservice modülünü yükleme.If you have the older module installed, uninstall it and then install the AIPService module.

Yeni modülün, eski modüldeki cmdlet adlarına diğer adları vardır, böylece mevcut betikler çalışmaya devam edecektir.The newer module has aliases to the cmdlet names in the older module so that any existing scripts will continue to work. Ancak, eski modülün destek dışı bırakmadan önce bu başvuruları güncelleştirmeyi planlayın.However, plan to update these references before the old module falls out of support. AADRM modülünün desteği 15 Temmuz 2020 tarihinde sona acaktır.Support for the AADRM module will end July 15, 2020.

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:If you installed the AADRM module from the PowerShell Gallery, to uninstall it, start a PowerShell session with the Run as Administrator option, and type:

Uninstall-Module -Name AADRM

AADRM modülünü Azure Rights Management yönetim aracı ile yüklediyseniz, Windows Azure AD Rights Management yönetiminikaldırmak için Programlar ve Özellikler ' i kullanın.If you installed the AADRM module with the Azure Rights Management Administration Tool, use Programs and Features to uninstall Windows Azure AD Rights Management Administration.

Aıpservice modülünü yüklemekHow to install the AIPService module

Aıpservice modülü PowerShell Galerisi ve Microsoft İndirme Merkezi ' nden kullanılamaz.The AIPService module is on the PowerShell Gallery and is not available from the Microsoft Download Center.

PowerShell Galerisi yeni başladıysanız, bkz. PowerShell Galerisi kullanmaya başlama.If you're new to the PowerShell Gallery, see Get Started with the PowerShell Gallery. PowerShellGet modülünü ve NuGet sağlayıcısını yüklemeyi kapsayan Galeri gereksinimleriyle ilgili yönergeleri izleyin.Follow the instructions for the gallery requirements, which include installing the PowerShellGet module and the NuGet provider.

PowerShell Galerisi Aıpservice modülüyle ilgili ayrıntıları görmek için aıpservice sayfasınıziyaret edin.To see details about the AIPService module on the PowerShell Gallery, visit the AIPService page.

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:To install the AIPService module, start a PowerShell session with the Run as Administrator option, and type:

Install-Module -Name AIPService

Güvenilmeyen bir depodan yükleme hakkında uyarı alırsanız, onaylamak için Y tuşuna basın.If you are warned about installing from an untrusted repository, you can press Y to confirm. Ya da, komutunu Set-PSRepository -Name PSGallery -InstallationPolicy Trusted kullanarak PowerShell Galerisi güvenilir bir depo olarak yapılandırın ve ardından aıpservice modülünü yüklemek için komutu yeniden çalıştırın.Or, press N and configure the PowerShell Gallery as a trusted repository by using the command Set-PSRepository -Name PSGallery -InstallationPolicy Trusted and then rerun the command to install the AIPService module.

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:If you have a previous version of the AIPService module installed from the Gallery, update it to the latest by typing:

Update-Module -Name AIPService

Sonraki adımlarNext steps

Bir Windows PowerShell oturumunda, yüklü modülün sürümünü onaylayın.In a Windows PowerShell session, confirm the version of the installed module. Bu denetim, özellikle de eski bir sürümden yükselttiyseniz önemlidir:This check is particularly important if you upgraded from an older version:

(Get-Module AIPService –ListAvailable).Version

Not: Bu komut başarısız olursa, önce Import-Module Aıpservicekomutunu çalıştırın.Note: If this command fails, first run Import-Module AIPService.

Hangi cmdlet'lerin kullanılabilir olduğunu görmek için şunu yazın:To see which cmdlets are available, type the following:

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.Use the Get-Help <cmdlet_name> command to see the Help for a specific cmdlet, and use the -online parameter to see the latest help on the Microsoft documentation site. Örneğin:For example:

Get-Help Connect-AipService -online

Daha fazla bilgi için:For more information:

Koruma hizmetini yapılandıran herhangi bir komutu çalıştırmadan önce, Connect-Aıpservice cmdlet 'ini kullanarak hizmete bağlanmanız gerekir.Before you can run any commands that configure the protection service, you must connect to the service by using the Connect-AipService cmdlet.

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.When you have finished running your configuration commands, as a best practice, disconnect from the service by using the Disconnect-AipService cmdlet. Bağlantıyı kesmezseniz bağlantı bir süre işlem yapılmadığında otomatik olarak kesilir.If you do not disconnect, the connection is automatically disconnected after a period of inactivity. Otomatik bağlantı kesme davranışı nedeniyle bir PowerShell oturumu sırasında zaman zaman yeniden bağlanmanız gerekebilir.Because of the automatic disconnection behavior, you might find that you need to occasionally reconnect in a PowerShell session.

Not

Koruma hizmeti henüz etkinleştirilmemişse, Enable-Aıpservice cmdlet 'ini kullanarak hizmeti bağladıktan sonra bunu yapabilirsiniz.If the protection service is not yet activated, you can do this after you have connected to the service, by using the Enable-AipService cmdlet.