Partager via

Get-AadrmUserLog

  • Référence
Module:
AADRM

Télécharge les journaux des utilisateurs Rights Management dans le stockage local.

Syntaxe

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

Description

Notes

Cette applet de commande du module AADRM est désormais déconseillée. Après le 15 juillet 2020, ce nom d’applet de commande ne sera pris en charge qu’en tant qu’alias pour son remplacement dans le module AIPService.

Pour plus d’informations, consultez la page de présentation.

L’applet de commande Get-AadrmUserLog télécharge Azure Rights Management journaux des utilisateurs vers le stockage local. Vous devez spécifier une date spécifique ou une plage de dates pour télécharger les entrées du journal.

Vous devez utiliser PowerShell pour obtenir ces journaux d’activité utilisateur ; vous ne pouvez pas effectuer cette action à l’aide d’un portail de gestion.

Lorsque vous exécutez cette commande et spécifiez une date uniquement pour les objets DateTime , l’heure est supposée être 00:00:00 dans votre heure locale, puis convertie en UTC.

Lorsque vous spécifiez une heure avec une date (par exemple, -ForDate « 2/1/2016 15:00:00 »), cette date et heure est convertie en UTC. La commande Get-AadrmUserLog obtient ensuite les journaux pour cette période UTC.

Consultez les exemples de la façon dont vous devrez peut-être modifier vos valeurs DateTime pour prendre en charge la conversion nécessaire pour votre heure locale.

Pour plus d’informations sur la journalisation de l’utilisation et un exemple pas à pas, consultez Journalisation et analyse de l’utilisation du service Azure Rights Management.

Exemples

Exemple 1 : Obtenir des journaux d’activité utilisateur pour une plage de dates

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

Cette commande télécharge les journaux d’activité utilisateur créés entre 12/12/2015 et 12/15/2015 (en heure UTC) dans le dossier C:\Logs.

La commande utilise 10 threads pour télécharger les journaux.

Exemple 2 : Obtenir les journaux d’activité des utilisateurs pour une date

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

Cette commande télécharge les journaux d’activité utilisateur pour 12/5/2015 (en heure UTC) dans le dossier C:\Logs.

Exemple 3 : Obtenir des journaux d’activité utilisateur pour une date, en tenant compte d’une conversion d’heure UTC +décalage

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

Cette commande montre comment vous devrez peut-être prendre en compte une conversion d’heure UTC +décalage à partir de votre heure locale, avant de télécharger les journaux des utilisateurs dans le dossier C:\Logs.

Vous êtes en Nouvelle-Zélande, ce qui signifie que l’heure locale de votre ordinateur est UTC+12 et que vous souhaitez télécharger les journaux pour 2/2016 pour votre heure locale plutôt que UTC. Si vous ne spécifiez pas l’heure de 12:00:00 avec la date, vos journaux d’activité contiennent des données uniquement pour les 12 premières heures de 2/2016 (et les 12 dernières heures du jour précédent).

Exemple 4 : Obtenir des journaux d’activité utilisateur pour une plage de dates, en tenant compte d’une conversion d’heure UTC -offset

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

Cette commande montre comment vous devrez peut-être prendre en compte une conversion d’heure UTC -offset de votre heure locale avant de télécharger les journaux des utilisateurs dans le dossier C:\Logs.

Vous êtes à Houston, aux États-Unis, ce qui signifie que l’heure locale de votre ordinateur est UTC-6 et que vous souhaitez télécharger les journaux d’activité de 2/2016 à 2/9/2016 pour votre heure locale plutôt que UTC.

Si vous n’avez pas spécifié la date et l’heure précédentes de 18:00:00, vos journaux d’activité sont manquants pour les 6 premières heures de 2/2016 votre heure locale (et 6 heures supplémentaires pour la date de fin).

Paramètres

-Force

Indique que cette applet de commande remplace, sans demander de confirmation, un fichier journal existant pour la même plage de dates ou de dates.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-ForDate

Spécifie une date (et éventuellement une heure) pour le fichier journal en tant qu’objet DateTime .

Utilisez ce paramètre lorsque vous n’utilisez pas le paramètre FromDate .

Pour obtenir un objet DateTime , utilisez l’applet de commande Get-Date .

Type:DateTime
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-FromDate

Spécifie la date de début (et éventuellement une heure) pour le fichier journal en tant qu’objet DateTime .

Utilisez ce paramètre lorsque vous n’utilisez pas le paramètre ForDate .

Si vous spécifiez ce paramètre, mais pas toDate, la date de fin est le jour où vous exécutez la commande.

Type:DateTime
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-NumberOfThreads

Spécifie le nombre de threads à utiliser pour télécharger les journaux.

Les valeurs acceptables pour ce paramètre sont les suivantes : 1-32.

La valeur par défaut est 3.

Type:Int32
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Path

Spécifie un chemin d’accès existant du dossier dans lequel enregistrer les journaux.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-ToDate

Spécifie la date d’arrêt (et éventuellement une heure) pour le fichier journal en tant qu’objet DateTime .

Si vous le souhaitez, spécifiez ce paramètre lorsque vous utilisez le paramètre FromDate pour spécifier une plage de dates spécifique. Si vous ne spécifiez pas ce paramètre lorsque vous utilisez le paramètre FromDate , la date de fin est le jour où vous exécutez la commande.

Type:DateTime
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False