Partilhar via


Get-AipServiceUserLog

Transfere os registos de utilizadores de proteção do Azure Information Protection para o armazenamento local.

Sintaxe

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 10

Este 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.

Tipo:SwitchParameter
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais: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 .

Tipo:DateTime
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais: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.

Tipo:DateTime
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais: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.

Tipo:Int32
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Path

Especifica um caminho existente da pasta na qual pretende guardar os registos.

Tipo:String
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais: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.

Tipo:DateTime
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False