Udostępnij za pośrednictwem

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 usługi 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.
  • Każde ustawienie wygaśnięcia, dostępu w trybie offline lub odwołania.

Można określić godzinę rozpoczęcia i czas 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 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:

  • ContentName
  • właściciel

Napiwek

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

Przykłady

Przykład 1: (tylko klient ujednoliconego etykietowania) Uzyskiwanie informacji o ochronie wszystkich śledzonych dokumentów z określoną nazwą pliku, które były chronione w określonym przedziale czasowym

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 wszystkich śledzonych dokumentów przechowywanych w dzierżawie z nazwą pliku test.docx, które były chronione w grudniu 2020 r.

Przykład 2: (tylko klient ujednoliconego etykietowania) Uzyskiwanie informacji o ochronie wszystkich śledzonych dokumentów z określoną nazwą pliku i właścicielem, 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 był chroniony przez użytkownika za pomocą alice@contoso.com poczty e-mail
  • Plik został chroniony w grudniu 2020 r.

Parametry

-Confirm

Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.

Typ:SwitchParameter
Aliasy:cf
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-ContentName

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

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

Napiwek

Jeśli używasz tego parametru, zalecamy również użycie filtrów dat FromTime i ToTime filtrów dat.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych: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 Get-Help Get-Date.

Typ:DateTime
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Owner

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

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych: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.

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

Typ:DateTime
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-WhatIf

Pokazuje, co się stanie, jeśli polecenie cmdlet zostanie uruchomione. Polecenie cmdlet nie jest uruchamiane.

Typ:SwitchParameter
Aliasy:wi
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False