Partilhar via

Get-AipServiceUserLog

Módulo:
AIPService Module

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

Sintaxe

Default (Padrão) 

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

Descrição

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.

Propriedades dos parâmetros

Tipo:SwitchParameter
Valor padrão:None
Suporta curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Posição:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome da propriedade:False
Valor dos argumentos restantes: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 .

Propriedades dos parâmetros

Tipo:DateTime
Valor padrão:None
Suporta curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Posição:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome da propriedade:False
Valor dos argumentos restantes: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.

Propriedades dos parâmetros

Tipo:DateTime
Valor padrão:None
Suporta curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Posição:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome da propriedade:False
Valor dos argumentos restantes: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.

Propriedades dos parâmetros

Tipo:Int32
Valor padrão:None
Suporta curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Posição:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome da propriedade:False
Valor dos argumentos restantes:False

-Path

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

Propriedades dos parâmetros

Tipo:String
Valor padrão:None
Suporta curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Posição:Named
Obrigatório:True
Valor do pipeline:True
Valor do pipeline por nome da propriedade:True
Valor dos argumentos restantes: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.

Propriedades dos parâmetros

Tipo:DateTime
Valor padrão:None
Suporta curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Posição:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome da propriedade:False
Valor dos argumentos restantes:False

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.