Export-DebugLogs
收集 Microsoft Purview 信息保护客户端和扫描程序日志文件并将其导出到压缩文件。
语法
Default (默认值)
Export-DebugLogs
[-FileName] <String>
[-OnBehalfOf <PSCredential>]
[<CommonParameters>]
说明
Export-DebugLogs cmdlet 从 %localappdata%\Microsoft\MSIP\Logs 收集所有客户端和扫描程序日志文件,并将它们保存到具有 .zip 格式的单个压缩文件中。 然后,如果系统要求你发送日志文件以帮助调查 Microsoft Purview 信息保护客户端或扫描程序的报告问题,则可以将此文件发送到 Microsoft 支持部门。
如果您需要从服务账户导出日志文件,请使用 OnBehalfOf 参数。 例如,已创建为以非交互方式运行的帐户,例如 MicrosoftPurview 信息保护扫描程序的帐户。
示例
示例 1
PS C:\> Export-DebugLogs -FileName C:\Logs\AIPLogs.zip
此命令收集所有导出的日志并将其保存到现有 C:\Logs 文件夹中的 AIPLogs.zip 文件中。
参数
-FileName
导出的日志文件的路径和文件名。
该路径可以是本地路径或网络路径(映射驱动器盘符或 UNC)。
路径中的任何文件夹都必须已存在。 如果指定的文件名已存在于指定文件夹中,则原始文件将被覆盖。
指定文件名时,请包括 .zip 文件扩展名。
参数属性
| 类型: | String |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | 0 |
| 必需: | True |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-OnBehalfOf
要使用此参数,您必须使用 Run as Administrator (以管理员身份运行) 选项运行 PowerShell 会话。
指定包含凭证对象的变量,当您需要从当前登录的账户以外的账户导出日志文件时,将使用该变量。 例如,需要收集运行 Microsoft Purview 信息保护扫描程序的服务帐户的日志文件。 在这种情况下,如果扫描程序与运行此 cmdlet 安装在同一台计算机上,则日志文件还包括扫描程序配置数据库中的一些信息。
使用 Get-Credentials cmdlet 创建存储凭据的变量。
参数属性
| 类型: | PSCredential |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
CommonParameters
此 cmdlet 支持通用参数:-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息,请参阅 about_CommonParameters。