Get-O365ClientOSDetailReport

  • Referenz
Modul:
ExchangePowerShell
Gilt für::
Exchange Online

Dieses Cmdlet ist nur im cloudbasierten Dienst verfügbar.

Dieses Cmdlet ist seit Januar 2018 veraltet. Informationen zu verfügbaren Microsoft Graph-Ersatzberichten in Microsoft 365 finden Sie in den Unterthemen vonArbeiten mit Microsoft 365-Nutzungsberichten in Microsoft Graph.

Verwenden Sie das Cmdlet Get-O365ClientOSDetailReport, um einen detaillierten Bericht zur Verwendung des Clientbetriebssystems zu erhalten.

Informationen zu den Parametersätzen im Abschnitt zur Syntax weiter unten finden Sie unter Syntax der Exchange-Cmdlets.

Syntax

Get-O365ClientOSDetailReport
   [-EndDate <DateTime>]
   [-OperatingSystem <String>]
   [-OperatingSystemVersion <String>]
   [-ResultSize <Unlimited>]
   [-StartDate <DateTime>]
   [-WindowsLiveID <String>]
   [<CommonParameters>]

Beschreibung

Dieser Bericht enthält Betriebssystemdetails für alle aktiven Benutzer. Die Daten enthalten maximal vier Betriebssysteme pro Benutzer, werden täglich aggregiert und 5 Tage lang aufbewahrt. In der folgenden Liste sind die Eigenschaften beschrieben, die in den Ergebnissen zurückgegeben werden.

  • TenantGuid: Eindeutiger Bezeichner des Mandanten.
  • TenantName: Mandantenname.
  • Datum: Der Zeitstempel für die Verbindung für die Kombination aus Betriebssystem und Version.
  • WindowsLiveID: Benutzer-ID im Format user@domain.
  • DisplayName: Benutzername.
  • LastAccessTime: Letztes Datum, an dem der Benutzer eine Verbindung mit diesem Betriebssystem und dieser Versionskombination hergestellt hat.
  • ObjectId: Benutzerobjekt-ID.
  • OperatingSystem: Name des Betriebssystems.
  • Version: Betriebssystemversion.
  • OperatingSystemUsageCount: Anzahl der Tage, die diese Kombination aus Betriebssystem und Version während des Berichts verwendet wurde

Bevor Sie dieses Cmdlet ausführen können, müssen Ihnen die entsprechenden Berechtigungen zugewiesen werden. Auch wenn in diesem Thema alle Parameter für das Cmdlet aufgeführt werden, verfügen Sie möglicherweise nicht über den Zugriff auf einige Parameter, wenn sie nicht in den Ihnen zugewiesenen Berechtigungen enthalten sind. Wie Sie herausfinden, welche Berechtigungen zur Ausführung eines bestimmten Cmdlets oder Parameters in Ihrer Organisation erforderlich sind, können Sie unter Find the permissions required to run any Exchange cmdlet nachlesen.

Beispiele

Beispiel 1

Get-O365ClientOSDetailReport -WindowsLiveID john@contoso.com -StartDate 05/01/2017 -EndDate 05/03/2017

In diesem Beispiel werden die Betriebssystemdetails für Benutzer John zwischen dem 1. Mai 2017 und dem 3. Mai 2017 abgerufen.

Beispiel 2

Get-O365ClientOSDetailReport -OperatingSystem Android

In diesem Beispiel werden die Betriebssystemdetails für das Android-Betriebssystem für den aktuellen Aufbewahrungszeitraum von 5 Tagen abgerufen (es sind kein Start- und Enddatum angegeben).

Parameter

-EndDate

Der EndDate-Parameter gibt das Enddatum des Datumsbereichs an.

Verwenden Sie das unter "Regionale Einstellungen" definierte kurze Datumsformat für den Computer, auf dem der Befehl ausgeführt wird. Wenn auf dem Computer z. B. das kurze Datumsformat TT.MM.JJJJ konfiguriert ist, geben Sie "01.09.2018" ein, um als Datum den 1. September 2018 anzugeben. Sie können entweder nur das Datum oder das Datum und die Uhrzeit angeben. Wenn Sie das Datum und die Uhrzeit eingeben, setzen Sie das den Wert in Anführungszeichen ("), z. B. "09.01.2018 17:00".

Type:DateTime
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-OperatingSystem

Der Parameter OS filtert den Bericht nach Betriebssystem. Wenn Sie diesen Parameter nicht verwenden, werden alle Betriebssysteme berücksichtigt. Folgende Werte sind für diesen Parameter zulässig:

  • Windows
  • Android
  • iOS
  • "Mac OS"
Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-OperatingSystemVersion

Der Parameter OperatingSystemVersion filtert den Bericht nach Betriebssystemversion. Wenn Sie diesen Parameter nicht verwenden, sind alle Betriebssystemversionen enthalten. Der Parameter akzeptiert Versionsnummern bis zur ersten Nebenversion. Verwenden Sie beispielsweise 6 oder 6.1, nicht 6.1.9600. Platzhalterzeichen werden nicht unterstützt.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-ResultSize

Der ResultSize-Parameter gibt die maximale Anzahl von zurückzugebenden Ergebnissen an. Wenn Sie alle Anforderungen zurückgeben möchten, die der Abfrage entsprechen, verwenden Sie unlimited als Wert für diesen Parameter. Der Standardwert ist 1000.

Type:Unlimited
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-StartDate

Der StartDate-Parameter gibt das Startdatum und die Uhrzeit des Datumsbereichs an.

Verwenden Sie das unter "Regionale Einstellungen" definierte kurze Datumsformat für den Computer, auf dem der Befehl ausgeführt wird. Wenn auf dem Computer z. B. das kurze Datumsformat TT.MM.JJJJ konfiguriert ist, geben Sie "01.09.2018" ein, um als Datum den 1. September 2018 anzugeben. Sie können entweder nur das Datum oder das Datum und die Uhrzeit angeben. Wenn Sie das Datum und die Uhrzeit eingeben, setzen Sie das den Wert in Anführungszeichen ("), z. B. "09.01.2018 17:00".

Type:DateTime
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-WindowsLiveID

Die WindowsLiveID filtert den Bericht nach Benutzer-ID.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online