Get-AipServiceDocumentLog
Gets protection information about documents that are tracked by Azure Information Protection.
This cmdlet is supported by both the Azure Information Protection classic and unified labeling clients, with different usage, as described below.
Синтаксис
Default (по умолчанию)
Get-AipServiceDocumentLog
-ContentName <String>
-Owner <String>
[-FromTime <DateTime>]
[-ToTime <DateTime>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Описание
The Get-AIPServiceDocumentLog cmdlet runs a query to return protection information about tracked documents.
Information returned includes:
- The document content ID, with the document name if available.
- The Rights Management owner and Rights Management issuer.
- The users and groups that were granted access.
- The protection template ID or specific usage rights that protect the document.
- Any expiry, offline access, or revocation setting.
You can specify a start time and stop time of entries to include. The output is returned as a list of PowerShell objects in the PowerShell console.
For more information, see Rights Management owners and IRights Management issuers.
When used with the unified labeling client, the query is based on the document name, the owner email, or both.
You must specify at least one of the following parameters:
- ContentName
- Owner
Tip
If you use the ContentName parameter, we recommend that you also use the FromTime and ToTime parameters to filter your content to a specific time period.
Примеры
Example 1: (Unified labeling client only) Get protection information about all tracked documents with a specific filename, which were protected in a specific timeframe
Get-AipServiceDocumentLog -ContentName "test.docx" -FromTime "12/01/2020 00:00:00" -ToTime "12/31/2020 23:59:59"
This command runs a query and returns protection information about all tracked documents stored on your tenant with the filename test.docx, which were protected in December 2020.
Example 2: (Unified labeling client only) Get protection information about all tracked documents with a specific filename and owner, which were protected in a specific timeframe
Get-AipServiceDocumentLog -ContentName "test.docx" -Owner “[email protected]” -FromTime "12/01/2020 00:00:00" -ToTime "12/31/2020 23:59:59"
This command runs a query and returns protection information about all tracked documents stored on your tenant that match the following details:
- The filename is test.docx
- The file was protected by a user with the email [email protected]
- The file was protected in December 2020.
Параметры
-Confirm
Prompts you for confirmation before running the cmdlet.
Свойства параметра
| Тип: | SwitchParameter |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
| Aliases: | cf |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-ContentName
Specifies the tracked document's full name, including the file extension.
If you have the unified labeling client, you must include either this parameter, or the Owner parameter, or you can include both.
Tip
If you use this parameter, we recommend that you also use the the FromTime and ToTime date filters to filter the data returned.
Свойства параметра
| Тип: | String |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | True |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-FromTime
Specifies the start time (inclusive) for the log file as a DateTime object. To obtain a DateTime object, use the Get-Date cmdlet. Specify the date and time according to your system locale settings.
For more information, type Get-Help Get-Date.
Свойства параметра
| Тип: | DateTime |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Owner
Specifies the email address of the user who protected the document (the Rights Management issuer or owner).
Свойства параметра
| Тип: | String |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | True |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-ToTime
Specifies the stop time (inclusive) for the log file as a DateTime object. To obtain a DateTime object, use the Get-Date cmdlet. Specify the date and time according to your system locale settings.
For more information, type Get-Help Get-Date.
Свойства параметра
| Тип: | DateTime |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-WhatIf
Shows what would happen if the cmdlet runs. The cmdlet is not run.
Свойства параметра
| Тип: | SwitchParameter |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
| Aliases: | wi |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
CommonParameters
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.