Get-AipServiceUserLog
Transfere os registos de utilizadores de proteção do Azure Information Protection para o armazenamento local.
Syntax
Get-AipServiceUserLog
-Path <String>
[-FromDate <DateTime>]
[-ToDate <DateTime>]
[-ForDate <DateTime>]
[-Force]
[-NumberOfThreads <Int32>]
[<CommonParameters>] Description
O cmdlet Get-AipServiceUserLog transfere os registos de utilizador de proteção para o armazenamento local. Tem de especificar uma data específica ou um intervalo de datas para transferir as entradas de registo.
Tem de utilizar o PowerShell para obter estes registos de utilizador; não pode efetuar esta ação através de um portal de gestão.
Quando executa este comando e especifica uma data apenas para os objetos DateTime , assume-se que a hora é 00:00:00 na hora local e, em seguida, convertida em UTC.
Quando especifica uma hora com uma data (por exemplo, -ForDate '1/2/2016 15:00:00'), essa data e hora são convertidas em UTC. Em seguida, o comando Get-AipServiceUserLog obtém os registos desse período de tempo UTC. Os registos de utilização só estão disponíveis quando o nome do campo "date" contém um valor de uma data anterior (na hora UTC). Os registos de utilização da data atual não estão disponíveis.
Veja os exemplos de como poderá ter de alterar os valores DateTime , para acomodar a conversão necessária para a hora local.
Para obter mais informações sobre o registo de utilização da proteção e um exemplo passo a passo, veja Registar e analisar a utilização da proteção do Azure In formation Protection.
Exemplos
Exemplo 1: Obter registos de utilizadores para um intervalo de datas
PS C:\>Get-AipServiceUserLog -Path 'C:\Logs' -FromDate '12/12/2015' -ToDate '12/15/2015' -NumberOfThreads 10Este comando transfere os registos de utilizador criados entre 12/12/2015 e 15/12/2015 (na hora UTC) para a pasta C:\Logs.
O comando utiliza 10 threads para transferir os registos.
Exemplo 2: Obter registos de utilizador para uma data
PS C:\>Get-AipServiceUserLog -Path 'C:\Logs' -ForDate '12/5/2015'Este comando transfere os registos do utilizador para 05/12/2015 (na hora UTC) para a pasta C:\Logs.
Exemplo 3: Obter registos de utilizador para uma data, tendo em conta uma conversão utc +tempo de deslocamento
PS C:\>Get-AipServiceUserLog -Path 'C:\Logs' -ForDate '2/2/2016 12:00:00'Este comando mostra como poderá ter de ter em conta uma conversão utc +tempo de deslocamento da hora local, antes de transferir os registos de utilizador para a pasta C:\Logs.
Está na Nova Zelândia, o que significa que a hora local do seu computador é UTC+12 e pretende transferir registos para 2/2/2016 para a sua hora local em vez de UTC. Se não especificou a hora das 12:00:00 com a data, os registos conteriam dados apenas para as primeiras 12 horas de 2/2/2016 (e as últimas 12 horas do dia anterior).
Exemplo 4: Obter registos de utilizadores para um intervalo de datas, tendo em conta uma conversão de tempo utc -offset
PS C:\>Get-AipServiceUserLog -Path 'C:\Logs' -FromDate '2/1/2016 18:00:00' -ToDate '2/9/15/2016 18:00:00'Este comando mostra como poderá ter de ter em conta uma conversão de tempo utc -offset da hora local antes de transferir os registos de utilizador para a pasta C:\Logs.
Está em Houston, EUA, o que significa que a hora local do seu computador é UTC-6 e quer transferir registos de 2/2/2016 a 09/02/2016 para a sua hora local em vez de UTC.
Se não especificou a data e hora anteriores de 18:00:00, os registos estariam em falta nos dados das primeiras 6 horas de 2/2/2016 da sua hora local (e mais 6 horas para a data de fim).
Parâmetros
-Force
Indica que este cmdlet substitui, sem pedir confirmação, um ficheiro de registo existente para a mesma data ou intervalo de datas.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ForDate
Especifica uma data (e, opcionalmente, uma hora) para o ficheiro de registo como um objeto DateTime .
Utilize este parâmetro quando não utilizar o parâmetro FromDate .
Para obter um objeto DateTime , utilize o cmdlet Get-Date .
| Type: | DateTime |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-FromDate
Especifica a data de início (e, opcionalmente, uma hora) para o ficheiro de registo como um objeto DateTime .
Utilize este parâmetro quando não utilizar o parâmetro ForDate .
Se especificar este parâmetro, mas não o ToDate, a data de fim é o dia em que executa o comando.
| Type: | DateTime |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-NumberOfThreads
Especifica o número de threads a utilizar para transferir registos.
Os valores aceitáveis para este parâmetro são: 1-32.
O valor predefinido é 3.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Path
Especifica um caminho existente da pasta na qual pretende guardar os registos.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-ToDate
Especifica a data de paragem (e, opcionalmente, uma hora) para o ficheiro de registo como um objeto DateTime .
Opcionalmente, especifique este parâmetro quando utilizar o parâmetro FromDate para especificar um intervalo de datas específico. Se não especificar este parâmetro quando utiliza o parâmetro FromDate , a data de fim é o dia em que executa o comando.
| Type: | DateTime |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |