AIPService PowerShell モジュールのインストールInstalling the AIPService PowerShell module

適用対象: Azure Information ProtectionOffice 365Applies to: Azure Information Protection, Office 365

Azure Information Protection から保護サービス用の Windows PowerShell モジュールをインストールするには、次の情報を参照してください。Use the following information to help you install the Windows PowerShell module for the protection service from Azure Information Protection. このモジュールの名前は AIPService で、AADRM という名前の以前のバージョンと置き換えられます。The name of this module is AIPService, and it replaces the previous version that was named AADRM.

この PowerShell モジュールを使用すると、インターネットに接続され、次のセクションに記載されている前提条件を満たす任意の Windows コンピューターを使用して、コマンドラインから保護サービス (Azure Rights Management) を管理できます。You can use this PowerShell module to administer the protection service (Azure Rights Management) from the command line by using any Windows computer that has an internet connection and that meets the prerequisites listed in the next section. Azure Information Protection 用の Windows PowerShell は、自動化のためのスクリプトをサポートするか、高度な構成シナリオで必要になる場合があります。Windows PowerShell for Azure Information Protection supports scripting for automation or might be necessary for advanced configuration scenarios. モジュールでサポートされている管理タスクと構成の詳細については、「 PowerShell を使用した Azure Information Protection からの保護の管理」を参照してください。For more information about the administration tasks and configurations that the module supports, see Administering protection from Azure Information Protection by using PowerShell.

必要条件Prerequisites

次の表に、Azure Information Protection から保護サービス用の AIPService PowerShell モジュールをインストールして使用するための前提条件を示します。This table lists the prerequisites to install and use the AIPService PowerShell module for the protection service from Azure Information Protection.

要件Requirement 説明を見るMore information
Windows PowerShell の最小バージョン: 3.0Minimum version of Windows PowerShell: 3.0 PowerShell セッションで「$PSVersionTable」と入力すると、実行中の Windows PowerShell のバージョンを確認できます。You can confirm the version of Windows PowerShell that you are running by typing $PSVersionTable in a PowerShell session.

新しいバージョンの Windows PowerShell をインストールする必要がある場合は、「既存の Windows PowerShell をアップグレードする」を参照してください。If you need to install a later version of Windows PowerShell, see Upgrading existing Windows PowerShell.
Microsoft .NET Framework の最小バージョン: 4.5Minimum version of the Microsoft .NET Framework: 4.5

注: このバージョンの Microsoft .NET Framework は、以降のオペレーティングシステムに含まれています。そのため、クライアントのオペレーティングシステムが Windows 8.0 より小さい場合、またはサーバーのオペレーティングシステムが Windows Server 2012 よりも小さい場合にのみ、手動でインストールする必要があります。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 の最小バージョンがまだインストールされていない場合は、Microsoft .NET Framework 4.5 をダウンロードできます。If the minimum version of the Microsoft .NET Framework is not already installed, you can download Microsoft .NET Framework 4.5.

この Microsoft .NET Framework の最小バージョンは、AIPService モジュールで使用されるクラスの一部に必要です。This minimum version of the Microsoft .NET Framework is required for some of the classes that the AIPService module uses.

AADRM モジュールがインストールされている場合If you have the AADRM module installed

AIPService モジュールは、古いモジュール AADRM を置き換えます。The AIPService module replaces the older module, AADRM. 古いモジュールがインストールされている場合は、アンインストールしてから、AIPService モジュールをインストールします。If you have the older module installed, uninstall it and then install the AIPService module.

新しいモジュールには、既存のスクリプトが引き続き機能するように、古いモジュール内のコマンドレット名のエイリアスがあります。The newer module has aliases to the cmdlet names in the older module so that any existing scripts will continue to work. ただし、古いモジュールがサポート対象外になる前に、これらの参照を更新することを計画してください。However, plan to update these references before the old module falls out of support. AADRM モジュールのサポートは2020年7月15日に終了します。Support for the AADRM module will end July 15, 2020.

PowerShell ギャラリーから AADRM モジュールをインストールした場合、アンインストールするには、 [管理者として実行] オプションを使用して PowerShell セッションを開始し、次のように入力します。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

Azure Rights Management 管理ツールを使用して AADRM モジュールをインストールした場合は、 [プログラムと機能] を使用して、 Windows Azure AD Rights Management 管理をアンインストールします。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.

AIPService モジュールをインストールする方法How to install the AIPService module

AIPService モジュールはPowerShell ギャラリー上にあり、Microsoft ダウンロードセンターからは使用できません。The AIPService module is on the PowerShell Gallery and is not available from the Microsoft Download Center.

PowerShell ギャラリーを初めてお使いの場合は、「PowerShell ギャラリーの概要」を参照してください。If you're new to the PowerShell Gallery, see Get Started with the PowerShell Gallery. PowerShellGet モジュールと NuGet プロバイダーのインストールを含む、ギャラリー要件の手順に従います。Follow the instructions for the gallery requirements, which include installing the PowerShellGet module and the NuGet provider.

PowerShell ギャラリーの AIPService モジュールの詳細を確認するには、 Aipservice のページにアクセスしてください。To see details about the AIPService module on the PowerShell Gallery, visit the AIPService page.

AIPService モジュールをインストールするには、 [管理者として実行] オプションを使用して PowerShell セッションを開始し、次のように入力します。To install the AIPService module, start a PowerShell session with the Run as Administrator option, and type:

Install-Module -Name AIPService

信頼されていないリポジトリからのインストールについての警告が表示される場合は、Y キーを押して確認できます。If you are warned about installing from an untrusted repository, you can press Y to confirm. または、N キーを押し、コマンド Set-PSRepository -Name PSGallery -InstallationPolicy Trusted を使用して PowerShell ギャラリーを信頼されたリポジトリとして構成してから、コマンドを再実行して AIPService モジュールをインストールします。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.

以前のバージョンの AIPService モジュールがギャラリーからインストールされている場合は、次のように入力して最新のバージョンに更新します。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

次のステップNext steps

Windows PowerShell セッションで、インストールされているモジュールのバージョンを確認します。In a Windows PowerShell session, confirm the version of the installed module. このチェックは、以前のバージョンからアップグレードした場合に特に重要です。This check is particularly important if you upgraded from an older version:

(Get-Module AIPService –ListAvailable).Version

注: このコマンドが失敗した場合は、最初にインポートモジュール AIPServiceを実行します。Note: If this command fails, first run Import-Module AIPService.

使用可能なコマンドレットを確認するには、次のコマンドを入力します。To see which cmdlets are available, type the following:

Get-Command -Module AIPService

Get-Help <cmdlet_name> コマンドを使って特定のコマンドレットのヘルプをご覧ください。また、 -online パラメーターを使って Microsoft のドキュメント サイトで最新のヘルプをご覧ください。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. たとえば、次のようになります。For example:

Get-Help Connect-AipService -online

詳細情報:For more information:

保護サービスを構成するコマンドを実行する前に、 connect-AipServiceコマンドレットを使用してサービスに接続する必要があります。Before you can run any commands that configure the protection service, you must connect to the service by using the Connect-AipService cmdlet.

構成コマンドの実行が完了したら、ベストプラクティスとして、 disconnect-AipServiceコマンドレットを使用してサービスから切断することをお勧めします。When you have finished running your configuration commands, as a best practice, disconnect from the service by using the Disconnect-AipService cmdlet. 切断しない場合は、非アクティブ状態の後に自動的に切断されます。If you do not disconnect, the connection is automatically disconnected after a period of inactivity. この自動切断の挙動によって、PowerShell セッションで再接続が必要になる場合があります。Because of the automatic disconnection behavior, you might find that you need to occasionally reconnect in a PowerShell session.

注意

保護サービスがまだアクティブになっていない場合は、 Enable-AipServiceコマンドレットを使用して、サービスに接続した後でこれを行うことができます。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.