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

以下の情報は、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 モジュールをインストールして使用するための前提条件が一覧表示されています。

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

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

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 セッションで時々再接続する必要がある場合があります。