Partilhar via

Get-AipServiceUserLog

  • Referência
Módulo:
AIPService

Downloads de logs de usuário de proteção da Proteção de Informações do Azure para o armazenamento local.

Sintaxe

Get-AipServiceUserLog
   -Path <String>
   [-FromDate <DateTime>]
   [-ToDate <DateTime>]
   [-ForDate <DateTime>]
   [-Force]
   [-NumberOfThreads <Int32>]
   [<CommonParameters>]

Description

O cmdlet Get-AipServiceUserLog baixa logs de usuário de proteção para o armazenamento local. Você deve especificar uma data específica ou um intervalo de datas para baixar as entradas de log.

Você deve usar o PowerShell para obter esses logs de usuário; Não é possível executar essa ação usando um portal de gerenciamento.

Quando executa este comando e especifica uma data apenas para os objetos DateTime, presume-se que a hora seja 00:00:00 na hora local e, em seguida, convertida em UTC.

Quando você especifica uma hora com uma data (por exemplo, -ForDate '2/1/2016 15:00:00'), essa data e hora são convertidas em UTC. O comando Get-AipServiceUserLog obtém os logs para esse período de tempo UTC. Os logs de uso só estão disponíveis quando o nome do campo "data" contém um valor de uma data anterior (em hora UTC). Os logs de uso da data atual não estão disponíveis.

Veja os exemplos de como você pode precisar alterar seus valores de DateTime, para acomodar a conversão necessária para sua hora local.

Para obter mais informações sobre o log de uso de proteção e um exemplo passo a passo, consulte Registro em log e analisando o uso de proteção do Azure In formation Protection.

Exemplos

Exemplo 1: Obter logs de usuário para um intervalo de datas

PS C:\>Get-AipServiceUserLog -Path 'C:\Logs' -FromDate '12/12/2015' -ToDate '12/15/2015' -NumberOfThreads 10

Este comando descarrega os registos de utilizador criados entre 12/12/2015 e 15/12/2015 (em tempo UTC) para a pasta C:\Logs.

O comando usa 10 threads para baixar os logs.

Exemplo 2: Obter logs de usuário para uma data

PS C:\>Get-AipServiceUserLog -Path 'C:\Logs' -ForDate '12/5/2015'

Este comando transfere os registos do utilizador para 12/5/2015 (em hora UTC) para a pasta C:\Logs.

Exemplo 3: Obter logs de usuário para uma data, levando em conta uma conversão de tempo UTC + offset

PS C:\>Get-AipServiceUserLog -Path 'C:\Logs' -ForDate '2/2/2016 12:00:00'

Este comando mostra como você pode precisar levar em conta uma conversão UTC + offset time da sua hora local, antes de baixar os logs do usuário para a pasta C:\Logs.

Você está na Nova Zelândia, o que significa que a hora local do seu computador é UTC+12 e você deseja baixar logs para 2/2/2016 para sua hora local em vez de UTC. Se você não especificou a hora de 12:00:00 com a data, seus logs conterão dados apenas para as primeiras 12 horas de 2/2/2016 (e as últimas 12 horas do dia anterior).

Exemplo 4: Obter logs de usuário para um intervalo de datas, levando em conta uma conversão de hora -offset UTC

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 você pode precisar levar em conta uma conversão de hora -offset UTC da sua hora local antes de baixar os logs do usuário para a pasta C:\Logs.

Você está em Houston, EUA, o que significa que a hora local do seu computador é UTC-6 e você deseja baixar logs de 2/2/2016 a 2/9/2016 para a sua hora local em vez de UTC.

Se você não especificou a data e hora anteriores de 18:00:00, seus logs estariam faltando dados para as primeiras 6 horas de 2/2/2016 sua hora local (e mais 6 horas para a data final).

Parâmetros

-Force

Indica que esse cmdlet substitui, sem solicitar confirmação, um arquivo de log 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 arquivo de log como um objeto DateTime .

Use esse parâmetro quando não usar o parâmetro FromDate.

Para obter um objeto DateTime, use 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 arquivo de log como um objeto DateTime .

Use esse parâmetro quando não usar o parâmetro ForDate.

Se você especificar esse parâmetro, mas não o ToDate, a data final será o dia em que você executar 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 serem usados para baixar logs.

Os valores aceitáveis para este parâmetro são: 1-32.

O valor padrão é 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 salvar os logs.

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

-ToDate

Especifica a data de parada (e, opcionalmente, uma hora) para o arquivo de log como um objeto DateTime .

Opcionalmente, especifique esse parâmetro ao usar o parâmetro FromDate para especificar um intervalo de datas específico. Se você não especificar esse parâmetro ao usar o parâmetro FromDate, a data final será o dia em que você executar o comando.

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