New-CMPrebootRecoveryInfo

配置 OS 驱动器锁定时预启动密钥恢复屏幕显示的恢复消息。

语法

New-CMPrebootRecoveryInfo
   [-PolicyState <State>]
   [-RecoveryMessage <String>]
   [-RecoveryUrl <Uri>]
   [-UseRecoveryMessage]
   [-UseRecoveryUrl]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]

说明

使用此 cmdlet 配置整个恢复消息或替换 OS 驱动器锁定时预启动密钥恢复屏幕显示的现有 URL。

如果同时使用 -UseRecoveryUrl-UseRecoveryMessage 参数,预启动密钥恢复屏幕将显示默认的 BitLocker 恢复消息和 URL。 如果以前配置了自定义恢复消息或 URL,并且想要还原为默认消息,请保持策略启用状态,并使用 -UseRecoveryUrl-UseRecoveryMessage 参数

注意

预启动不支持所有字符和语言。 测试要用于自定义消息或 URL 的字符。 确保预启动恢复屏幕正确显示自定义消息或 URL。

示例

示例 1:使用自定义恢复消息和 URL 启用的新策略

此示例创建一个使用自定义值启用的新策略。

New-CMPrebootRecoveryInfo -PolicyState Enabled -UseRecoveryMessage -RecoveryMessage "Contact the Contoso Helpdesk at 515-555-8127 or https://contoso.com/bitlockerrecovery"

示例 2:使用自定义恢复 URL 启用的新策略

New-CMPrebootRecoveryInfo -PolicyState Enabled -UseRecoveryUrl -RecoveryUrl https://contoso.com/bitlockerrecovery

参数

-DisableWildcardHandling

此参数将通配符视为文本字符值。 不能将其与 ForceWildcardHandling 组合使用。

类型:SwitchParameter
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-ForceWildcardHandling

此参数处理通配符,并可能导致意外行为, (不建议) 。 不能将其与 DisableWildcardHandling 组合使用。

类型:SwitchParameter
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-PolicyState

使用此参数配置策略。

  • Enabled:如果启用此策略,BitLocker 将使用指定的自定义信息。

  • DisabledNotConfigured:如果禁用或不配置此策略,BitLocker 将使用默认信息。

类型:State
接受的值:Enabled, Disabled, NotConfigured
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-RecoveryMessage

指定要在预启动恢复屏幕上显示的自定义消息。 如果还需要指定恢复 URL,请将其包含在此自定义恢复消息中。 最大字符串长度为 32,768 个字符。 将此参数与 -UseRecoveryMessage 参数一起使用。

类型:String
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-RecoveryUrl

替换预启动 BitLocker 恢复屏幕中显示的默认 URL。 最大 URI 长度为 32,768 个字符。 将此参数与 -UseRecoveryUrl 参数一起使用。

类型:Uri
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-UseRecoveryMessage

如果添加此参数,预启动密钥恢复屏幕将显示 -RecoveryMessage 的值。

类型:SwitchParameter
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-UseRecoveryUrl

如果添加此参数,则为 -RecoveryUrl 指定的 URL 将替换默认恢复消息中的默认 URL。

类型:SwitchParameter
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

输入

None

输出

Microsoft.ConfigurationManagement.AdminConsole.BitlockerManagement.PolicyObject