Get-O365ClientOSReport

  • リファレンス
モジュール:
ExchangePowerShell
適用対象:
Exchange Online

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

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

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

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

構文

Get-O365ClientOSReport
   [-EndDate <DateTime>]
   [-OS <String>]
   [-ResultSize <Unlimited>]
   [-StartDate <DateTime>]
   [<CommonParameters>]

説明

このレポートは、OS パラメーター説明に示されるオペレーティング システムの最も新しい 5 つのバージョンについて、クライアントの使用統計を表示します。 以前のすべてのバージョンは、「その他」という 6 つ目のカテゴリにまとめられています。 次のリストでは、結果で返されるプロパティについて説明します。

  • TenantGuid: テナントの一意の識別子。
  • TenantName: テナント名。
  • 日付: 明細データが集計された最後の時刻。
  • オペレーティング システム: オペレーティング システム名。
  • バージョン: オペレーティング システムのバージョン。
  • OperatingSystemUsageCount: レポート期間中に特定のオペレーティング システムとバージョンの組み合わせがサービスに接続された回数。

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

例

例 1

Get-O365ClientOSReport -OS Windows

次の使用例は、366 日のデータ保有期間 (開始日と終了日が指定されていない) に対するクライアント Windows の使用の概要レポートを取得します。

例 2

Get-O365ClientOSReport -StartDate 06/13/2014 -EndDate 06/15/2014

この例では、2014 年 6 月 13 日から 2014 年 6 月 15 日までの間にクライアント オペレーティング システム情報を取得します。

パラメーター

-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

-OS

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

-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 パラメーターは、日付範囲の開始日を指定します。

コマンドを実行するコンピューターの [地域のオプション] 設定で定義されている短い日付形式を使用します。 たとえば、短い日付形式 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