Get-AadrmUserLog

Descarrega registos de utilizadores de Gestão de Direitos para armazenamento local.

Syntax

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

Description

Nota

Este cmdlet do módulo AADRM está agora depreciado. Depois de 15 de julho de 2020, este nome cmdlet será suportado apenas como um pseudónimo à sua substituição no módulo AIPService.

Para mais informações, consulte a página geral.

O cmdlet Get-AadrmUserLog transfere os registos de utilizadores da Azure Rights Management para o armazenamento local. Tem de especificar uma data específica ou um intervalo de data para descarregar as entradas de registo.

Tem de utilizar o PowerShell para obter estes registos de utilizador; não é possível fazer esta ação utilizando um portal de gestão.

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

Quando especifica uma hora com uma data (por exemplo, -ForDate "2/1/2016 15:00:00"), essa data e hora são convertidas para UTC. O comando Get-AadrmUserLog obtém então os registos para esse período de tempo UTC.

Consulte os exemplos de como poderá necessitar de alterar os valores do DateTime , para acomodar a conversão necessária para a sua hora local.

Para obter mais informações sobre o registo de registos de utilização e um exemplo passo a passo, consulte registar e analisar o uso do serviço de Gestão de Direitos Azure.

Exemplos

Exemplo 1: Obtenha registos de utilizador para um intervalo de datas

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

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

O comando utiliza 10 fios para descarregar os registos.

Exemplo 2: Obtenha registos de utilizador para uma data

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

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

Exemplo 3: Obtenha registos de utilizador para uma data, tendo em conta uma conversão de tempo UTC +offset

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

Este comando mostra como poderá ter em conta uma conversão de tempo UTC +offset a partir da sua hora local, antes de transferir registos de utilizador 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ê quer baixar 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 seus registos conteriam apenas dados para as primeiras 12 horas de 2/2/2016 (e as últimas 12 horas do dia anterior).

Exemplo 4: Obtenha registos de utilizador para um intervalo de datas, tendo em conta uma conversão de tempo de compensação UTC

PS C:\>Get-AadrmUserLog -Path 'C:\Logs' -FromDate 2/1/2016 18:00:00 -ToDate 2/9/15/2016 18:00:00

Este comando mostra como poderá ter em conta uma conversão de tempo de compensação UTC a partir da sua hora local antes de transferir registos de utilizador para a pasta C:\Logs.

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

Se não especificou a data e hora anteriores das 18:00:00, os seus registos estariam em falta para as primeiras 6 horas de 2/2/2016 da sua hora local (e mais 6 horas para a data de final).

Parâmetros

-Force

Indica que este cmdlet substitui, sem solicitação de confirmação, um ficheiro de registo existente para a mesma data ou intervalo de data.

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 final é o dia em que executar 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 linhas a utilizar para descarregar 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 para 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 utilizar o parâmetro FromDate , a data de fim é o dia em que executar o comando.

Type:DateTime
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False