Udostępnij przez


Get-AipServiceDocumentLog

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

Default (Domyślne)

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 (Nazwa zawartości)
  • Właściciel

Wskazówka

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

Prosi o potwierdzenie przed uruchomieniem cmdletu.

Właściwości parametrów

Typ:SwitchParameter
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False
Aliasy:por

Zbiory parametrów

(All)
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów: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.

Wskazówka

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

Właściwości parametrów

Typ:String
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

(All)
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:True
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów: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.

Właściwości parametrów

Typ:DateTime
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

(All)
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False

-Owner

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

Właściwości parametrów

Typ:String
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

(All)
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:True
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów: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.

Właściwości parametrów

Typ:DateTime
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

(All)
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False

-WhatIf

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

Właściwości parametrów

Typ:SwitchParameter
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False
Aliasy:Wi

Zbiory parametrów

(All)
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False

CommonParameters

To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters.