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 モジュールをインストールして使用するための前提条件が一覧表示されています。
| 要件 | 詳細情報 |
|---|---|
| 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 セッションで時々再接続する必要がある場合があります。
Note
保護サービスがまだアクティブ化されていない場合は、サービスに接続した後で、Enable-AipService コマンドレットを使用してアクティブ化することができます。