Edit

Share via


New-CMNoOverwritePolicy

Create a policy to control computer restart performance at the risk of exposing BitLocker secrets.

Syntax

Default (Default)

New-CMNoOverwritePolicy
    [-PolicyState <State>]
    [-DisableWildcardHandling]
    [-ForceWildcardHandling]
    [<CommonParameters>]

Description

Create a policy to control computer restart performance at the risk of exposing BitLocker secrets. BitLocker secrets include key material used to encrypt data. This policy applies only when you enable BitLocker protection.

Examples

Example 1: New default enabled policy

This example creates a policy that's not configured.

New-CMNoOverwritePolicy -PolicyState NotConfigured

Parameters

-DisableWildcardHandling

This parameter treats wildcard characters as literal character values. You can't combine it with ForceWildcardHandling.

Parameter properties

Type:SwitchParameter
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-ForceWildcardHandling

This parameter processes wildcard characters and may lead to unexpected behavior (not recommended). You can't combine it with DisableWildcardHandling.

Parameter properties

Type:SwitchParameter
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-PolicyState

Use this parameter to configure the policy.

  • Enabled: If you enable this policy, memory isn't overwritten when the computer restarts. Preventing memory overwrite may improve restart performance, but it increases the risk of exposing BitLocker secrets.

  • Disabled or NotConfigured: If you disable or don't configure this policy, BitLocker secrets are removed from memory when the computer restarts.

Parameter properties

Type:State
Default value:None
Accepted values:Enabled, Disabled, NotConfigured
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.

Inputs

None

Outputs

System.Object