Get-O365ClientOSDetailReport

リファレンス

モジュール:: ExchangePowerShell

適用対象:: Exchange Online

このコマンドレットは、クラウドベースのサービスでのみ使用できます。

このコマンドレットは、2018 年 1 月に廃止されました。 Microsoft 365 で置換可能な Microsoft Graph レポートの詳細については、Microsoft Graph で Microsoft 365 利用状況レポートを使用するのサブトピックを参照してください。

Get-O365ClientOSDetailReport コマンドレットを使用して、クライアントオペレーティングシステムの使用に関する詳細なレポートを入手します。

以下の構文セクションのパラメーターセットの詳細については、「Exchangeのコマンドレット構文」を参照してください。

構文

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

説明

このレポートは、すべてのアクティブユーザーのオペレーティングシステムの詳細を説明します。データにはユーザーごとに最大 4 つのオペレーティングシステムが含まれ、それらが毎日集計されて、5 日間保持されます。結果で返されるプロパティは、次の一覧で説明します。

TenantGuid: テナントの一意の識別子。
TenantName: テナント名。
日付: オペレーティングシステムとバージョンの組み合わせの接続のタイムスタンプ。
WindowsLiveID: user@domain形式のユーザー ID。
DisplayName: ユーザー名。
LastAccessTime: ユーザーがこのオペレーティングシステムとバージョンの組み合わせに接続した最終日付。
ObjectId: ユーザーオブジェクト ID。
オペレーティングシステム: オペレーティングシステム名。
バージョン: オペレーティングシステムのバージョン。
OperatingSystemUsageCount: レポートの期間中にこのオペレーティングシステムとバージョンの組み合わせが使用された日数

このコマンドレットを実行する際には、あらかじめアクセス許可を割り当てる必要があります。このトピックにはこのコマンドレットのすべてのパラメーターが一覧表示されていますが、自分に割り当てられているアクセス許可に含まれていない一部のパラメーターにはアクセスできません。コマンドレットを組織内で実行するために必要になるアクセス許可とパラメーターを調べるには、「 Find the permissions required to run any Exchange cmdlet」を参照してください。

例

例 1

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

この例では、2017 年 5 月 1 日から 2017 年 5 月 3 日の間に、ユーザー John のオペレーティングシステムの詳細を取得します。

例 2

Get-O365ClientOSDetailReport -OperatingSystem Android

次の例は、現在の 5 日間の保持期間 (開始日付と終了日付は指定されない) に対する Android オペレーティングシステムのオペレーティングシステム詳細を取得します。

パラメーター

-EndDate

EndDate パラメーターには、日付範囲の終了日を指定します。

コマンドを実行するコンピューターの [地域のオプション] 設定で定義されている短い日付形式を使用します。たとえば、短い日付形式 mm/dd/yyyy を使用するようにコンピューターが構成されている場合は、「09/01/2018」と入力して 2018 年 9 月 1 日を指定します。日付のみを入力したり、日付と時刻を入力することもできます。日付と時刻を入力する場合は、値を引用符 (”) で囲む必要があります (例: "09/01/2018 5:00 PM")。

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

-OperatingSystem

OS パラメーターは、オペレーティングシステムごとにフィルタリングします。このパラメーターを使用しない場合、すべてのオペレーティングシステムが含まれます。このパラメーターの有効な値は次のとおりです:

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

OperatingSystemVersion パラメーターは、オペレーティングシステムのバージョンによってレポートをフィルター処理します。このパラメーターを使用しない場合、すべてのオペレーティングシステムのバージョンが含まれます。このパラメーターには、最初のマイナーバージョンまでのバージョン番号を指定できます。例えば、6 や 6.1 を使用できますが、6.1.9600 は使用できません。ワイルドカードは使用できません。

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

-ResultSize

ResultSize パラメーターは、返される結果の最大数を指定します。クエリに一致するすべてのリクエストを返す場合は、このパラメーターの値に unlimited を使用します。既定値は 1,000 です。

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

-StartDate

StartDate パラメーターは、日付範囲の開始日を指定します。

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

-WindowsLiveID

WindowsLiveID はレポートをユーザー ID ごとにフィルタリングします。

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