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

[アーティクル]
12/12/2023

以下の情報は、Azure Information Protection から保護サービス用 Windows PowerShell モジュールをインストールする場合に役立ちます。このモジュールの名前は AIPService であり、AADRM という名前の以前のバージョンを置き換えます。

この PowerShell モジュールを使用すると、インターネットに接続され、次のセクションでリストする前提条件を満たす任意の Windows コンピューターを使って、コマンドラインから保護サービス (Azure Rights Management) を管理できます。 Azure Information Protection 用の Windows PowerShell は、自動化のためのスクリプトをサポートし、高度な構成シナリオのために必要になる場合があります。管理タスクと、モジュールがサポートする構成に関する詳細については、「PowerShell を使用した Azure Information Protection からの保護の管理」を参照してください。

前提条件

この表には、Azure Information Protection から保護サービス用 AIPService PowerShell モジュールをインストールして使用するための前提条件が一覧表示されています。

要件	詳細情報
Windows PowerShell の最小バージョン	Version 3.0 実行している Windows PowerShell のバージョンを確認するには、「PowerShell セッション」を入力`$PSVersionTable`します。新しいバージョンの Windows PowerShell をインストールする必要がある場合は、「既存の Windows PowerShell をアップグレードする」を参照してください。 AIPService PowerShell モジュールでは、Windows PowerShell のみをサポートすることに注意してください。 PowerShell ７はサポートされていません。
Microsoft .NET Framework の最小バージョン	Version 4.8 注: 最近のオペレーティングシステムには、このバージョンの Microsoft .NET Framework が付属しています。このため、手動でインストールする必要があるのは、クライアントのオペレーティングシステムが Windows 8.0 よりも前のバージョンの場合か、サーバーのオペレーティングシステムが Windows Server 2012 よりも前のバージョンの場合に限ります。 Microsoft .NET Framework の最小バージョンがまだインストールできない場合は、Microsoft .NET Framework 4.8 をダウンロードできます。この最小バージョンの Microsoft .NET Framework は、AIPService モジュールで使用されるクラスの一部で必要になります。
必要なライセンス	この機能を使用するには、製品ライセンスが必要です。詳細については、セキュリティとコンプライアンスに関する Microsoft 365 ライセンスガイダンス - サービスの説明を参照してください。

AADRM モジュールがインストールされている場合

AIPService モジュールは、古いモジュールである AADRM を置き換えます。古いモジュールがインストールされている場合は、それをアンインストールしてから、AIPService モジュールをインストールします。

新しいモジュールには、既存のスクリプトが引き続き機能するように、古いモジュールのコマンドレット名のエイリアスがあります。ただし、古いモジュールがサポート対象外になる前に、これらの参照の更新を計画してください。 AADRM モジュールのサポートは、2020 年 7 月 15 日に終了します。

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

Uninstall-Module -Name AADRM

AADRM モジュールを Azure Rights Management 管理ツールでインストールした場合は、 [プログラムと機能] を使用して [Windows Azure AD Rights Management の管理] をアンインストールします。

AIPService モジュールをインストールする方法

AIPService モジュールは PowerShell ギャラリーにあり、Microsoft ダウンロードセンターからは入手できません。

PowerShell ギャラリーから AIPService モジュールをインストールするには

PowerShell Gallery を初めて使う場合は、「PowerShell Gallery の概要」をご覧ください。ギャラリーの要件 (PowerShellGet モジュールと NuGet プロバイダーのインストールを含めて) の手順に従ってください。

PowerShell ギャラリーで AIPService モジュールの詳細を確認するには、AIPService に関するページを参照してください。

AIPService モジュールをインストールするには、[管理者として実行] オプションを使用して PowerShell セッションを開始し、次のように入力します。

Install-Module -Name AIPService

信頼されていないリポジトリからのインストールについて警告が表示された場合は、Y キーを押して確認できます。または、N キーを押し、Set-PSRepository -Name PSGallery -InstallationPolicy Trusted コマンドを使って信頼されたリポジトリとして PowerShell ギャラリーを構成した後、コマンドを再び実行して AIPService モジュールをインストールします。

以前のバージョンの AIPService モジュールをギャラリーからインストールした場合は、次のように入力して最新バージョンに更新します。

Update-Module -Name AIPService

次のステップ

Windows PowerShell セッションで、インストールされているモジュールのバージョンを確認する。このチェックは、古いバージョンからアップグレードした場合に特に重要です。

(Get-Module AIPService –ListAvailable).Version

Note

このコマンドが失敗した場合は、最初に Import-Module AIPService を実行します。

使用できるコマンドレットを確認するには、次のように入力してください。

Get-Command -Module AIPService

Get-Help <cmdlet_name> コマンドを使用して特定のコマンドレットのヘルプを表示し、-online パラメーターを使用して Microsoft ドキュメントサイトの最新のヘルプを表示します。次に例を示します。

Get-Help Connect-AipService -online

詳細情報:

使用可能なすべてのコマンドレットの一覧: AIPService モジュール
PowerShell をサポートする主な構成シナリオの一覧: PowerShell を使用した Azure Information Protection からの保護の管理

保護サービスを構成するコマンドを実行するには、Connect-AipService コマンドレットを使用して前もってサービスに接続しておく必要があります。

構成コマンドの実行が完了したら、ベストプラクティスとしては、Disconnect-AipService コマンドレットを使用してサービスとの接続を切断します。接続を切断しない場合、非アクティブな期間が経過すると、接続は自動的に切断されます。自動切断の動作により、PowerShell セッションで時々再接続する必要がある場合があります。