Unprotect-RMSFile

  • リファレンス
モジュール:
AzureInformationProtection

RMS で現在保護されているファイルの保護を解除します。

構文

Unprotect-RMSFile
         [-File <String>]
         [-Folder <String>]
         [-InPlace]
         [-Recurse]
         [-OutputFolder <String>]
         [-SupressUI]
         [-LogFile <String>]
         [-ProcessContainers]
         [<CommonParameters>]

説明

Unprotect-RMSFile コマンドレットは、指定したフォルダー内の 1 つ以上のファイルが以前に AD RMS または Azure RMS によって保護されていた場合に、Rights Management (RMS) 保護を削除します。

十分な使用権限を持っているか、組織がファイルの保護を解除するためのスーパー ユーザーである必要があります。 詳細については、「Azure Information Protection および探索サービスまたはデータの回復用のスーパー ユーザーの構成」をご覧ください。

コンテナー ファイルの保護を解除している場合、各子は再帰的に抽出、保護解除、再パッケージ化されます。 サポートされているコンテナー ファイルの種類は 、.zip、 .rar、 .7z、 .msg、 および .pst です。

.pst ファイルの場合、このコマンドレットでサポートされる最大ファイル サイズは 5 GB です。

このコマンドレットを実行すると、次のオプションがあります。

  • 元の保護されたファイルと新しい保護されていないファイルが共存するように、ファイルは同じフォルダー内で保護されていません。

  • 元のファイルは保護されたままで、保護されていないバージョンのファイルが別の場所に作成されます。

  • 指定したフォルダー内のすべてのファイルは、保護された元のファイルを置き換えて、現在の場所で保護されていません。

  • 指定したフォルダー内のすべてのファイルは保護されたままで、各ファイルの保護されていないバージョンが別の場所に作成されます。

このコマンドは、並列で実行される各コマンドに 対して LogFile パラメーターに異なるパスを指定した場合に同時に実行できます。 別のログ ファイル パスを指定せず、前のコマンドが完了していない場合、新しいコマンドは失敗します。

例

例 1: 1 つのファイルの保護を解除し、元のファイルを置き換える

PS C:\>Unprotect-RMSFile -File "C:\Test.ptxt" -InPlace
InputFile         DecryptedFile
---------         -------------
C:\Test.ptxt      C:\ Test.txt

このコマンドは 、Test.ptxt という名前の 1 つのファイルの保護を解除します。この保護されたバージョンのファイルは、同じ場所にある保護されていないバージョンに置き換えます。 出力ディレクトリを指定せず 、InPlace パラメーターを指定すると、ソース ファイルが置き換えられます。

例 2: 1 つのファイルの保護を解除し、元のファイルを保持する

PS C:\>Unprotect-RMSFile -File "C:\Test.ptxt" -OutputFolder "C:\Temp"
InputFile       DecryptedFile
---------       -------------
C:\Test.ptxt    C:\Temp\Test.txt

このコマンドは、1 つのファイルの保護を解除しますが、 C:\Temp という名前のフォルダーの場所に保護されていないバージョンを作成することで、元の保護されたファイルを保持します。出力フォルダーを指定すると、保護されていないファイルに対して一意のファイル名が作成されます。 同じ名前のファイルが存在する場合、新しいファイル名は、同じファイル名の一意のコピーを作成エクスプローラーのと同じ方法で一意になります。 たとえば、 Test.txt が存在する場合は、 テスト Copy.txt が作成され、テスト コピー (2).txt。

例 3: フォルダーの保護を解除する

PS C:\>Unprotect-RMSFile -Folder "C:\Protected" -OutputFolder "C:\Temp"
InputFile                  DecryptedFile
---------                  -------------
C:\Protected\Test.ptxt     C:\Temp\Protected\Test.txt

C:\Protected\Word.docx     C:\Temp\Protected\Word.docx

このコマンドは、フォルダーの保護を解除し、元の保護されたファイルを保持し、C :\Temp という名前のフォルダーの場所に保護されていないバージョンを作成し、"Protected" の対応するサブフォルダーを作成します。

このコマンドは、サブフォルダーの処理を含めるかどうかを決定する Recurse パラメーターと共に使用することもできます。

例 4: 保護を解除します。PST ファイル

PS C:\>Unprotect-RMSFile -File "C:\Test.pst" -OutputFolder "C:\Temp"
InputFile     DecryptedFile
---------     -------------
C:\Test.pst   C:\Temp\Test.pst

このコマンドは、Microsoft Outlook .msg ファイルを保持できるコンテナー ファイルである .pst (Personal Storage Table) ファイルの保護を解除します。

さらに、これらの .msg ファイルは、添付ファイルを保持するコンテナーにすることができます。 .pst ファイルはコンテナーであるため、すべての子ファイルと入れ子になったコンテナーも、この操作によって保護解除されます。

例 5: .RAR ファイルの保護を解除する

PS C:\>Unprotect-RMSFile -File "C:\Test.rar" -OutputFolder "C:\Temp"
InputFile     DecryptedFile
---------     -------------
C:\Test.rar   C:\Temp\Test.zip

このコマンドは、 .rar アーカイブ ファイルの保護を解除します。 .rar ファイルは入れ子になったファイルを保持するコンテナー ファイルであるため、これらの入れ子になったファイルはアーカイブにすることもできます。 すべての子ファイルと入れ子になったコンテナーも、この操作によって保護解除されます。

.rar入力ファイルの場合、保護されていないファイルは.zipファイルであることに注意してください。

パラメーター

-File

保護を解除するパスとファイルを指定します。 パスには、ドライブ文字または UNC を指定できます。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Folder

保護を解除するパスとフォルダーを指定します。 指定したフォルダー内のすべてのファイルの保護が解除されます。

パスには、ドライブ文字または UNC を指定できます。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-InPlace

指定したフォルダー内のファイルは、元の保護されたファイルを置き換えて、現在の場所で保護されていません。 OutputFolder パラメーターが指定されている場合、このパラメーターは無視されます。

InPlace も OutputFolder も指定されていない場合、ファイルがコピーされ、同じフォルダーに貼り付けるときに使用されるのと同じ名前付け エクスプローラー規則を使用して、ファイル名に "-Copy" が追加された新しいファイルが現在のディレクトリに作成されます。 たとえば、 Document.docx を含むファイルが保護されている場合、保護されていないバージョンの名前は Document-Copy.docxです。 Document-Copy.docxという名前のファイルが既に存在する場合は、Document-Copy(2).docxが作成されます。

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-LogFile

ログ ファイルのファイル名拡張子を省略可能なパスとベース ファイル名を指定します。 これらのログ ファイルには、保護が正常または失敗したファイルが一覧表示されます。 成功、失敗、デバッグのために、それぞれ次の 3 つのログ ファイルが作成されます。

  • <ファイル名>。<ファイル名拡張子>

  • <ファイル名>の失敗。<ファイル名拡張子>

  • <ファイル名>-debug。<ファイル名拡張子>

コンテナー ファイルの場合、これらのログ ファイルには入れ子になったファイルも含まれます。

たとえば、このパラメーター にC:\Users\Administrator\Unprotect-RMSFile.txt を指定すると、次のログ ファイルが作成されます。

  • 正常に保護されていないファイルの場合: C:\Users\Administrator\Unprotect-RMSFile.txt

  • 保護されていないファイルの場合: C:\Users\Administrator\Unprotect-RMSFile-failure.txt

  • デバッグ情報: C:\Users\Administrator\Unprotect-RMSFile-debug.txt

パスには、ドライブ文字または UNC を指定できます。

このパラメーターを指定しない場合、ログ ファイル Success.log、 Failure.log、 Debug.log は 、%localappdata%\Microsoft\MSIPC\pscmdlet\Logs[GUID]の既定のログ ファイルの場所に書き込まれます。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-OutputFolder

保護されていないバージョンの保護されたファイルの出力フォルダーを指定します。 元のフォルダー構造が維持されます。つまり、指定した値に対してサブフォルダーが作成される可能性があります。

パスには、ドライブ文字または UNC を使用できます。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ProcessContainers

このパラメーターは現在実装されていません。

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Recurse

この操作によって、すべてのサブフォルダー内のすべてのファイルの保護が解除されることを示します。

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SupressUI

このパラメーターは実装されていません。このコマンドレットの UI はありません。

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False