Start-ScannerDiagnostics
为本地安装的 Microsoft Purview 信息保护扫描程序服务启动一系列运行状况检查。
语法
Default (默认值)
Get0ScannerDiagnostics
[-OnBehalfOf <PSCredential>]
[-ResetConfig]
[-VerboseErrorCount <integer>]
[<CommonParameters>]
说明
View-ScannerReports cmdlet 会触发一系列诊断检查,以验证扫描程序部署是否正常。
诊断检查包括:
- 数据库是 up-to日期且可访问
- URL 可访问
- 找到身份验证令牌,并且可以获取策略
- 配置文件已设置
- 离线/在线配置存在并且可以获取
- 规则有效
示例
示例 1:启动本地安装的扫描程序的诊断工具
PS C:\> $scanner_account_creds= Get-Credential
PS C:\> View-ScannerReports -onbehalf $scanner_account_creds
此示例提示您输入特定账户的凭证,然后提供用于运行扫描程序的服务账户的凭证。
示例 2:启动诊断工具,并从扫描程序日志打印大量错误
PS C:\> $scanner_account_creds= Get-Credential
PS C:\> View-ScannerReports -onbehalf $scanner_account_creds -Verbose -VerboseErrorCount 30
此示例提示您输入特定账户的凭证,然后提供用于运行扫描程序的服务账户的凭证。 最后 30 个错误是从扫描程序日志中打印的。
参数
-OnBehalfOf
定义当您在非扫描程序用户的用户下运行命令时,要在其中运行诊断的扫描程序。
OnBehalfOf 值定义保存 credentials 对象的变量。 诊断检查在扫描程序上运行,用于该 credentials 对象定义的帐户。
使用 Get-Credential cmdlet 获取存储凭据的变量。
注释
如果您在 scanner 用户下运行该命令,则此参数不是必需的。
参数属性
| 类型: | PSCredential |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-ResetConfig
重置策略缓存。 使用时,即使上次刷新发生在不到 4 小时之前,也会刷新策略。
参数属性
| 类型: | SwitchParameter |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-VerboseErrorCount
仅当在命令中使用 Verbose 参数时才相关。
如果要打印除默认值 10 以外的错误数,则定义要从扫描程序日志中打印的错误数。
参数属性
| 类型: | Integer |
| 默认值: | 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。
输出
System.Object
备注
此 cmdlet 要求在 -OnBehalfOf 参数中定义特定的扫描程序帐户。 OnBehalfOf 参数要求您以管理员身份运行 PowerShell 会话。
诊断检查会检查扫描程序部署先决条件。 只有在部署了扫描程序并 配置了配置文件后,才支持此 cmdlet。
有关详细信息,请参阅 部署 Microsoft Purview 信息保护扫描程序。