Get-AipServiceDocumentLog

Odwołanie

Moduł:: AIPService

Pobiera informacje o ochronie dokumentów śledzonych przez usługę Azure Information Protection.

To polecenie cmdlet jest obsługiwane zarówno przez klientów klasycznych i ujednoliconych etykietowania platformy Azure Information Protection z różnymi użyciemi, jak opisano poniżej.

Składnia

Get-AipServiceDocumentLog
   -ContentName <String>
   -Owner <String>
   [-FromTime <DateTime>]
   [-ToTime <DateTime>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Opis

Polecenie cmdlet Get-AIPServiceDocumentLog uruchamia zapytanie zwracające informacje o ochronie śledzonych dokumentów.

Zwrócone informacje obejmują:

Identyfikator zawartości dokumentu z nazwą dokumentu, jeśli jest dostępny.
Właściciel usługi Rights Management i wystawca usługi Rights Management.
Użytkownicy i grupy, którym udzielono dostępu.
Identyfikator szablonu ochrony lub określone prawa użytkowania, które chronią dokument.
Wszelkie ustawienia wygaśnięcia, dostępu w trybie offline lub odwołania.

Możesz określić godzinę rozpoczęcia i godzinę zatrzymania wpisów do uwzględnienia. Dane wyjściowe są zwracane jako lista obiektów programu PowerShell w konsoli programu PowerShell.

Aby uzyskać więcej informacji, zobacz Rights Management owner and IRights Management issuers (Właściciele usługi Rights Management i wystawcy usługi IRights Management).

W przypadku użycia z klientem ujednoliconego etykietowania zapytanie jest oparte na nazwie dokumentu, adresie e-mail właściciela lub obu tych elementach.

Należy określić co najmniej jeden z następujących parametrów:

Nazwa zawartości
Właściciel

Porada

Jeśli używasz parametru ContentName , zalecamy również użycie parametrów FromTime i ToTime do filtrowania zawartości do określonego okresu.

Przykłady

Przykład 1: (tylko ujednolicony klient etykietowania) Uzyskiwanie informacji o ochronie wszystkich śledzonych dokumentów o określonej nazwie pliku, które były chronione w określonym przedziale czasu

Get-AipServiceDocumentLog -ContentName "test.docx" -FromTime "12/01/2020 00:00:00" -ToTime "12/31/2020 23:59:59"

To polecenie uruchamia zapytanie i zwraca informacje o ochronie dotyczące wszystkich śledzonych dokumentów przechowywanych w dzierżawie przy użyciu nazwy pliku test.docx, które były chronione w grudniu 2020 r.

Przykład 2: (tylko ujednolicony klient etykietowania) Uzyskiwanie informacji o ochronie wszystkich śledzonych dokumentów o określonej nazwie pliku i właścicielu, które były chronione w określonym przedziale czasu

Get-AipServiceDocumentLog -ContentName "test.docx" -Owner “alice@microsoft.com” -FromTime "12/01/2020 00:00:00" -ToTime "12/31/2020 23:59:59"

To polecenie uruchamia zapytanie i zwraca informacje o ochronie dotyczące wszystkich śledzonych dokumentów przechowywanych w dzierżawie, które są zgodne z następującymi szczegółami:

Nazwa pliku jest test.docx
Plik został chroniony przez użytkownika pocztą e-mail alice@contoso.com
Plik został chroniony w grudniu 2020 r.

Parametry

-Confirm

Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.

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

-ContentName

Określa pełną nazwę śledzonego dokumentu, w tym rozszerzenie pliku.

Jeśli masz ujednoliconego klienta etykietowania, musisz dołączyć ten parametr lub parametr Właściciel albo dołączyć oba te elementy.

Porada

Jeśli używasz tego parametru, zalecamy również filtrowanie zwróconych danych za pomocą filtrów daty FromTime i ToTime .

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

-FromTime

Określa godzinę rozpoczęcia (włącznie) dla pliku dziennika jako obiekt DateTime . Aby uzyskać obiekt DateTime , użyj polecenia cmdlet Get-Date . Określ datę i godzinę zgodnie z ustawieniami ustawień regionalnych systemu.

Aby uzyskać więcej informacji, wpisz polecenie Get-Help Get-Date.

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

-Owner

Określa adres e-mail użytkownika, który chronił dokument (wystawca lub właściciel usługi Rights Management).

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

-ToTime

Określa czas zatrzymania (włącznie) dla pliku dziennika jako obiekt DateTime . Aby uzyskać obiekt DateTime , użyj polecenia cmdlet Get-Date . Określ datę i godzinę zgodnie z ustawieniami ustawień regionalnych systemu.