Export-SPOQueryLogs
Office 365 テナント内のユーザーのクエリ ログをエクスポートします。
注:
2022 年 2 月より、Microsoft 365 の SharePoint から Export-SPOQueryLogs コマンドを削除する予定です。 代わりに 、マイ アカウントのプライバシー ポータルから Microsoft Search クエリ履歴ログをダウンロードすることをお勧めします。
構文
Default (既定)
Export-SPOQueryLogs
[-StartTime <DateTime>]
-LoginName <String>
-OutputFolder <String>
[<CommonParameters>]
説明
Office 365 テナント内のユーザーのクエリ ログをエクスポートします。 エクスポートの結果は、現在の作業フォルダーまたは指定されたフォルダーの 2 つのファイル loginName_queries.csv と loginName_personalQueries.csv に保存されます。
queries.csv の出力は次のようになります。
| QueryTime | QueryText |
|---|---|
| 5/31/2018 09:16 | querytext1 |
| 5/31/2018 08:16 | クエリ テキスト 2 |
コマンドレットを実行するには、テナント管理者である必要があります。
SharePoint Online の Windows PowerShell のアクセス許可と最新の情報については、「SharePoint Online 管理シェルの概要」を参照してください。
例
例 1
Export-SPOQueryLogs -LoginName user1@contoso.sharepoint.com
例 1 では、電子メール アドレスが user1@contoso.sharepoint.com されているユーザーのクエリ ログを、現在の作業フォルダーにある 2 つのファイル user1@contoso.sharepoint.com_queries.csv と user1@contoso.sharepoint.com_personalQueries.csv にエクスポートします。
例 2
Export-SPOQueryLogs -LoginName user1@contoso.sharepoint.com -StartTime "2018-10-21" -OutputFolder "c:\users\contosoadmin\Documents"
例 2 では、開始時刻 21 からクエリ ログをエクスポートします。 2018 年 10 月、電子メール アドレスが user1@contoso.sharepoint.com のユーザーに対して、フォルダー c:\users\contosoadmin\Documents にある 2 つのファイル user1@contoso.sharepoint.com_queries.csv と user1@contoso.sharepoint.com_personalQueries.csv に。
パラメーター
-LoginName
適用対象: SharePoint Online
エクスポートするユーザーのログイン名を指定します。
パラメーターのプロパティ
| 型: | System.String |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-OutputFolder
適用対象: SharePoint Online
CSV ファイルが生成されるターゲット フォルダー。
パラメーターのプロパティ
| 型: | System.String |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-StartTime
適用対象: SharePoint Online
ログをエクスポートする時点を指定します。 日付の形式は YYYY-MM-DD を使用します。
パラメーターのプロパティ
| 型: | System.DateTime |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
CommonParameters
このコマンドレットは、共通パラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable をサポートします。 詳細については、「about_CommonParameters」を参照してください。