Unprotect-RMSFile

  • Odwołanie
Moduł:
AzureInformationProtection

Usuwa ochronę pliku, który jest obecnie chroniony przez usługę RMS.

Składnia

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

Opis

Polecenie cmdlet Unprotect-RMSFile usuwa ochronę usługi Rights Management (RMS) z co najmniej jednego pliku w określonym folderze, jeśli te pliki były wcześniej chronione przez usługi AD RMS lub Azure RMS.

Aby wyłączyć ochronę plików, musisz mieć wystarczające prawa użytkowania lub być administratorem organizacji. Aby uzyskać więcej informacji, zobacz Konfigurowanie superu użytkowników dla usług Azure Information Protection i odnajdywania lub odzyskiwania danych.

Jeśli nie chronisz pliku kontenera, każde dziecko jest cyklicznie wyodrębniane, niechronione i ponownie pakowane. Obsługiwane typy plików kontenera to .zip, .rar, .7z, . msg i .pst.

W przypadku plików pst 5 GB jest maksymalnym rozmiarem pliku obsługiwanym za pomocą tego polecenia cmdlet.

Po uruchomieniu tego polecenia cmdlet dostępne są następujące opcje:

  • Plik jest niechroniony w tym samym folderze, aby oryginalny chroniony plik i nowy niechroniony plik współistnieł.

  • Oryginalny plik pozostaje chroniony, a niechroniona wersja pliku jest tworzona w innej lokalizacji.

  • Wszystkie pliki w określonym folderze są niechronione w bieżącej lokalizacji, zastępując oryginalne pliki, które były chronione.

  • Wszystkie pliki w określonym folderze pozostają chronione, a niechroniona wersja każdego pliku jest tworzona w innej lokalizacji.

To polecenie można uruchomić jednocześnie po określeniu innej ścieżki dla parametru LogFile dla każdego polecenia uruchamianego równolegle. Jeśli nie określisz innej ścieżki pliku dziennika, a poprzednie polecenie nie zostało zakończone, nowe polecenie zakończy się niepowodzeniem.

Przykłady

Przykład 1. Usuwanie ochrony pojedynczego pliku, zastępując oryginalny plik

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

To polecenie nie chroni pojedynczego pliku o nazwie Test.ptxt, zastępując tę chronioną wersję pliku wersją niechronioną w tej samej lokalizacji. Jeśli katalog wyjściowy nie zostanie podany i zostanie określony parametr InPlace , plik źródłowy zostanie zastąpiony.

Przykład 2. Usuwanie ochrony pojedynczego pliku, zachowywanie oryginalnego pliku

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

To polecenie usuwa ochronę pojedynczego pliku, ale zachowuje oryginalny chroniony plik, tworząc niechronioną wersję w lokalizacji folderu o nazwie C:\Temp. Po podaniu folderu wyjściowego jest tworzona unikatowa nazwa pliku dla niechronionego pliku. Jeśli plik o tej samej nazwie istnieje, nowa nazwa pliku jest unikatowa w taki sam sposób, jak Eksplorator plików tworzy unikatową kopię tej samej nazwy pliku. Jeśli na przykład Test.txt istnieje, zostanie utworzony Copy.txttestowy , a następnie .txtTest Copy(2).txt.

Przykład 3. Usuwanie ochrony folderu

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

To polecenie powoduje usunięcie ochrony folderu, zachowanie oryginalnych chronionych plików i utworzenie niechronionych wersji w lokalizacji folderu o nazwie C:\Temp i utworzenie odpowiedniego podfolderu "Chronione".

To polecenie może być również używane z parametrem Recurse , który określa, czy należy uwzględnić przetwarzanie podfolderów.

Przykład 4. Usuwanie ochrony elementu . Plik PST

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

To polecenie nie chroni pliku .pst (Osobista tabela magazynu), które są plikami kontenerów, które mogą przechowywać pliki msg programu Microsoft Outlook.

Z kolei te pliki msg mogą być kontenerami, które przechowują załączniki. Ponieważ plik pst jest kontenerem, każdy plik podrzędny i kontener zagnieżdżony również nie są chronione przez tę operację.

Przykład 5. Usuwanie ochrony pliku .RAR

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

To polecenie nie chroni pliku archiwum .rar . Ponieważ pliki.rar to pliki kontenera, które przechowują zagnieżdżone pliki, te zagnieżdżone pliki mogą być również archiwami. Każdy plik podrzędny i kontener zagnieżdżony również nie są chronione przez tę operację.

Zwróć uwagę, że w przypadku pliku wejściowego .rar plik niechroniony jest plikiem.zip .

Parametry

-File

Określa ścieżkę i plik, aby wyłączyć ochronę. Dla ścieżki można określić literę dysku lub UNC.

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

-Folder

Określa ścieżkę i folder, aby wyłączyć ochronę. Wszystkie pliki w określonym folderze będą niechronione.

Dla ścieżki można określić literę dysku lub UNC.

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

-InPlace

Plik lub pliki w określonym folderze nie są chronione w bieżącej lokalizacji, zastępując oryginalny chroniony plik lub pliki. Ten parametr jest ignorowany, jeśli określono parametr OutputFolder .

Jeśli nie określono elementu InPlace ani OutputFolder, nowy plik zostanie utworzony w bieżącym katalogu z dołączonym ciągiem "-Copy" do nazwy pliku, używając tej samej konwencji nazewnictwa, która Eksplorator plików używa, gdy plik jest kopiowany i wklejany do tego samego folderu. Jeśli na przykład plik z Document.docx jest chroniony, niechroniona wersja nosi nazwę Document-Copy.docx. Jeśli plik o nazwie Document-Copy.docx już istnieje, zostanie utworzony plik Document-Copy(2).docx itd.

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

-LogFile

Określa ścieżkę i nazwę pliku podstawowego z opcjonalnym rozszerzeniem nazwy pliku dla plików dziennika. Te pliki dziennika zawierają listę plików, które są pomyślnie lub niesprawdnie niechronione. Następujące trzy pliki dziennika są tworzone odpowiednio pod kątem powodzenia, niepowodzenia i debugowania:

  • <nazwa> pliku.< rozszerzenie nazwy pliku>

  • <file name-failure>.< rozszerzenie nazwy pliku>

  • <nazwa> pliku — debugowanie.< rozszerzenie nazwy pliku>

W przypadku plików kontenerów te pliki dziennika zawierają również pliki zagnieżdżone.

Jeśli na przykład określisz C:\Users\Administrator\Unprotect-RMSFile.txt dla tego parametru, zostaną utworzone następujące pliki dziennika:

  • W przypadku plików, które zostały pomyślnie niechronione: C:\Users\Administrator\Unprotect-RMSFile.txt

  • W przypadku plików, których nie można chronić: C:\Users\Administrator\Unprotect-RMSFile-failure.txt

  • Informacje o debugowaniu: C:\Users\Administrator\Unprotect-RMSFile-debug.txt

Dla ścieżki można określić literę dysku lub UNC.

Jeśli nie określisz tego parametru, pliki dziennika Success.log, Failure.log i Debug.log są zapisywane w domyślnej lokalizacji pliku dziennika %localappdata%\Microsoft\MSIPC\pscmdlet\Logs[GUID].

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

-OutputFolder

Określa folder wyjściowy dla niechronionych wersji chronionych plików. Zachowana jest oryginalna struktura folderów, co oznacza, że podfoldery mogą zostać utworzone dla określonej wartości.

Dla ścieżki można użyć litery dysku lub UNC.

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

-ProcessContainers

Ten parametr nie jest obecnie implementowany.

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

-Recurse

Wskazuje, że ta operacja nie chroni wszystkich plików we wszystkich podfolderach.

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

-SupressUI

Ten parametr nie jest implementowany; dla tego polecenia cmdlet nie ma interfejsu użytkownika.

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