Compartilhar via

Get-AipServiceUserLog

  • Referência
Módulo:
AIPService

Baixa os 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; você não pode fazer essa ação usando um portal de gerenciamento.

Quando você executa esse comando e especifica uma data apenas para os objetos DateTime, a hora é considerada 00:00:00 em sua hora local e depois convertida em UTC.

Quando você especifica uma hora com uma data (por exemplo, -ForDate '1/2/2016 15:00:00'), essa data e hora são convertidas em UTC. O comando Get-AipServiceUserLog, em seguida, 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 "date" contém um valor de uma data anterior (na 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 DateTime para acomodar a conversão necessária para sua hora local.

Para obter mais informações sobre o registro em 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

Esse comando baixa os logs de usuário criados entre 12/12/2015 e 15/12/2015 (no horário 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'

Esse comando baixa os logs de usuário para 5/12/2015 (no horário 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 +deslocamento

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 de tempo UTC +deslocamento de sua hora local, antes de baixar os logs de 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 das 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 tempo de -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 talvez seja necessário levar em conta uma conversão de tempo de -offset UTC de sua hora local antes de baixar os logs de 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 9/02/2016 para sua hora local em vez de UTC.

Se você não especificou a data e a hora anteriores das 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 de término).

Parâmetros

-Force

Indica que esse cmdlet substitui, sem solicitar confirmação, um arquivo de log existente para o mesmo intervalo de datas ou datas.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ForDate

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

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

Para obter um objeto DateTime, use o cmdlet Get-Date.

Tipo:DateTime
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga: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 você não usar o parâmetro ForDate.

Se você especificar esse parâmetro, mas não o ToDate, a data de término será o dia em que você executará o comando.

Tipo:DateTime
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-NumberOfThreads

Especifica o número de threads a serem usados para baixar logs.

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

O valor padrão é 3.

Tipo:Int32
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Path

Especifica um caminho existente da pasta na qual salvar os logs.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga: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 de término será o dia em que você executará o comando.

Tipo:DateTime
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False