次の情報を使用して、Microsoft Purview Information Protectionから Azure Right Management 暗号化サービスのWindows PowerShell モジュールをインストールするのに役立ちます。 このモジュールの名前は AIPService で、AADRM という名前の以前のバージョンが置き換えられます。
この PowerShell モジュールを使用すると、インターネット接続があり、次のセクションに記載されている前提条件を満たす Windows コンピューターを使用して、コマンド ラインから Azure Rights Management 暗号化サービスを管理できます。 Azure Rights Management 用のWindows PowerShellでは、自動化のスクリプトがサポートされているか、高度な構成シナリオに必要な場合があります。 モジュールがサポートする管理タスクと構成の詳細については、「 PowerShell を使用した Azure Rights Management サービスの管理」を参照してください。
前提条件
次の表に、Azure Rights Management 暗号化サービスの AIPService PowerShell モジュールをインストールして使用するための前提条件を示します。
| 要件 | 詳細情報 |
|---|---|
| Windows PowerShellの最小バージョン | バージョン 3.0 実行しているWindows PowerShellのバージョンを確認するには、PowerShell セッションで「 $PSVersionTable」と入力します。 新しいバージョンのWindows PowerShellをインストールする必要がある場合は、「既存のWindows PowerShellのアップグレード」を参照してください。 AIPService PowerShell モジュールでは、Windows PowerShellのみがサポートされることに注意してください。 PowerShell 7 はサポートされていません。 |
| Microsoft .NET Frameworkの最小バージョン | バージョン 4.8 この最小バージョンの Microsoft .NET Frameworkは、以降のオペレーティング システムに含まれていますが、まだインストールされていない場合は、Microsoft .NET Framework 4.8 をダウンロードできます。 この最小バージョンの Microsoft .NET Frameworkは、AIPService モジュールで使用されるクラスの一部に必要です。 |
| 必要なライセンス | この機能を使用するには、製品ライセンスが必要です。 詳細については、「 セキュリティ & コンプライアンスの Microsoft 365 ライセンス ガイダンス - サービスの説明」を参照してください。 |
AADRM モジュールがインストールされている場合
AIPService モジュールは、古いモジュール AADRM に置き換えられます。 古いモジュールがインストールされている場合は、それをアンインストールしてから AIPService モジュールをインストールします。
新しいモジュールには、既存のスクリプトが引き続き機能するように、以前のモジュールのコマンドレット名にエイリアスがあります。 古いモジュールは、2020 年 7 月 15 日のサポート対象外です。
PowerShell ギャラリーから AADRM モジュールをインストールした場合は、アンインストールするには、[管理者として実行] オプションを使用して PowerShell セッションを開始し、次のように入力します。
Uninstall-Module -Name AADRM
Azure Rights Management 管理ツールを使用して AADRM モジュールをインストールした場合は、Windows アプリケーションの削除手順を使用して Windows Azure AD Rights Management 管理をアンインストールします。
AIPService モジュールをインストールする方法
AIPService モジュールはPowerShell ギャラリーにあり、Microsoft ダウンロード センターからは入手できません。
PowerShell ギャラリーから AIPService モジュールをインストールするには
PowerShell ギャラリーを初めて使用する場合は、「PowerShell ギャラリーの概要」を参照してください。 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
注:
このコマンドが失敗した場合は、最初に Import-Module AIPService を実行します。
使用可能なコマンドレットを確認するには、次のように入力します。
Get-Command -Module AIPService
Get-Help <cmdlet_name> コマンドを使用して特定のコマンドレットのヘルプを表示し、-online パラメーターを使用して Microsoft ドキュメント サイトの最新のヘルプを表示します。 例:
Get-Help Connect-AipService -online
詳細情報:
使用可能なコマンドレットの完全な一覧: AIPService モジュール
PowerShell をサポートする主要な構成シナリオの一覧: PowerShell を使用した Azure Rights Management サービスの管理
Azure Rights Management サービスを構成するコマンドを実行するには、 Connect-AipService コマンドレットを使用してサービスに接続する必要があります。
構成コマンドの実行が完了したら、ベスト プラクティスとして、 Disconnect-AipService コマンドレットを使用してサービスから切断します。 切断しない場合、非アクティブな期間が経過すると、接続は自動的に切断されます。 自動切断動作のため、PowerShell セッションで再接続する必要がある場合があります。
注:
Azure Rights Management サービスがまだアクティブ化されていない場合は、 Enable-AipService コマンドレットを使用して、サービスに接続した後でこれを行うことができます。