Freigeben über

Get-AadrmUserLog

  • Referenz
Modul:
AADRM

Lädt Benutzerprotokolle für die Rechteverwaltung auf den lokalen Speicher herunter.

Syntax

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

Beschreibung

Hinweis

Dieses Cmdlet aus dem AADRM-Modul ist jetzt veraltet. Nach dem 15. Juli 2020 wird dieser Cmdletname nur als Alias für seine Ersetzung im AIPService-Modul unterstützt.

Weitere Informationen finden Sie auf der Seite mit der Übersicht.

Das Cmdlet Get-AadrmUserLog lädt Azure Rights Management-Benutzerprotokolle auf lokalen Speicher herunter. Sie müssen entweder ein bestimmtes Datum oder einen Datumsbereich angeben, um die Protokolleinträge herunterzuladen.

Sie müssen PowerShell verwenden, um diese Benutzerprotokolle abzurufen; Sie können diese Aktion nicht mithilfe eines Verwaltungsportals ausführen.

Wenn Sie diesen Befehl ausführen und ein Datum nur für die DateTime-Objekte angeben, wird davon ausgegangen, dass die Uhrzeit in Ihrer lokalen Uhrzeit 00:00:00 ist und dann in UTC konvertiert wird.

Wenn Sie eine Uhrzeit mit einem Datum angeben (z. B. -ForDate "2/1/2016 15:00:00"), wird dieses Datum und die Uhrzeit in UTC konvertiert. Der Befehl "Get-AadrmUserLog " ruft dann die Protokolle für diesen UTC-Zeitraum ab.

In den Beispielen erfahren Sie, wie Sie Ihre DateTime-Werte ändern müssen, um die für Ihre lokale Zeit erforderliche Konvertierung zu berücksichtigen.

Weitere Informationen zur Verwendungsprotokollierung und einem schrittweisen Beispiel finden Sie unter Protokollierung und Analyse der Verwendung des Azure Rights Management-Diensts.

Beispiele

Beispiel 1: Abrufen von Benutzerprotokollen für einen Datumsbereich

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

Dieser Befehl lädt Benutzerprotokolle herunter, die zwischen 12.12.2015 und 12.15.2015 (in UTC-Zeit) in den Ordner C:\Logs erstellt wurden.

Der Befehl verwendet 10 Threads, um die Protokolle herunterzuladen.

Beispiel 2: Abrufen von Benutzerprotokollen für ein Datum

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

Dieser Befehl lädt die Benutzerprotokolle für 12/5/2015 (in UTC-Zeit) in den Ordner C:\Logs herunter.

Beispiel 3: Abrufen von Benutzerprotokollen für ein Datum unter Berücksichtigung einer UTC+Offset-Zeitkonvertierung

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

Dieser Befehl zeigt, wie Sie möglicherweise eine UTC +offset-Zeitkonvertierung von Ihrer lokalen Zeit berücksichtigen müssen, bevor Sie Benutzerprotokolle in den Ordner C:\Logs herunterladen.

Sie befinden sich in Neuseeland, was bedeutet, dass die lokale Uhrzeit Ihres Computers UTC+12 ist und Sie Protokolle für 2/2/2016 für Ihre lokale Uhrzeit anstelle von UTC herunterladen möchten. Wenn Sie die Uhrzeit von 12:00:00 Uhr nicht mit dem Datum angegeben haben, würden Ihre Protokolle Daten nur für die ersten 12 Stunden von 2/2/2016 (und die letzten 12 Stunden des vorherigen Tages) enthalten.

Beispiel 4: Abrufen von Benutzerprotokollen für einen Datumsbereich unter Berücksichtigung einer UTC-Offset-Zeitkonvertierung

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

Dieser Befehl zeigt, wie Sie möglicherweise eine UTC-Offset-Zeitkonvertierung von Ihrer lokalen Zeit berücksichtigen müssen, bevor Benutzerprotokolle in den Ordner C:\Logs heruntergeladen werden.

Sie befinden sich in Houston, USA, was bedeutet, dass die lokale Uhrzeit Ihres Computers UTC-6 ist und Sie Protokolle von 2/2/2016 bis 2/9/2016 für Ihre lokale Zeit anstelle von UTC herunterladen möchten.

Wenn Sie das vorherige Datum und die Uhrzeit von 18:00:00 nicht angegeben haben, fehlen Ihre Protokolle daten für die ersten 6 Stunden von 2/2/2016 Ihrer lokalen Uhrzeit (und weitere 6 Stunden für das Enddatum).

Parameter

-Force

Gibt an, dass dieses Cmdlet ohne Aufforderung zur Bestätigung eine vorhandene Protokolldatei für denselben Datums- oder Datumsbereich überschreibt.

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

-ForDate

Gibt ein Datum (und optional eine Uhrzeit) für die Protokolldatei als DateTime-Objekt an.

Verwenden Sie diesen Parameter, wenn Sie den FromDate-Parameter nicht verwenden.

Verwenden Sie zum Abrufen eines DateTime-Objekts das Cmdlet "Get-Date ".

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

-FromDate

Gibt das Startdatum (und optional eine Uhrzeit) für die Protokolldatei als DateTime-Objekt an.

Verwenden Sie diesen Parameter, wenn Sie den ForDate-Parameter nicht verwenden.

Wenn Sie diesen Parameter, aber nicht das ToDate angeben, ist das Enddatum der Tag, an dem Sie den Befehl ausführen.

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

-NumberOfThreads

Gibt die Anzahl der Threads an, die zum Herunterladen von Protokollen verwendet werden sollen.

Die zulässigen Werte für diesen Parameter sind: 1-32.

Der Standardwert ist 3.

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

-Path

Gibt einen vorhandenen Pfad des Ordners an, in dem die Protokolle gespeichert werden sollen.

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

-ToDate

Gibt das Stoppdatum (und optional eine Uhrzeit) für die Protokolldatei als DateTime-Objekt an.

Geben Sie optional diesen Parameter an, wenn Sie den FromDate-Parameter verwenden, um einen bestimmten Datumsbereich anzugeben. Wenn Sie diesen Parameter nicht angeben, wenn Sie den FromDate-Parameter verwenden, ist das Enddatum der Tag, an dem Sie den Befehl ausführen.

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