Unprotect-RMSFile
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.
Typ: | String |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | 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.
Typ: | String |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | 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.
Typ: | SwitchParameter |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | 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].
Typ: | String |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | 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.
Typ: | String |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-ProcessContainers
Ten parametr nie jest obecnie implementowany.
Typ: | SwitchParameter |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-Recurse
Wskazuje, że ta operacja nie chroni wszystkich plików we wszystkich podfolderach.
Typ: | SwitchParameter |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-SupressUI
Ten parametr nie jest implementowany; dla tego polecenia cmdlet nie ma interfejsu użytkownika.
Typ: | SwitchParameter |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |