Reset-HcsFactoryDefault

Reset-HcsFactoryDefault

Resets one or both controllers to a factory default state.

Syntax

Parameter Set: Default
Reset-HcsFactoryDefault [[-Format] <String> {Quick | Full} ] [[-Scope] <ClusterScope> {Cluster | Controller} ] [-Force] [ <CommonParameters>]

Detailed Description

The Reset-HcsFactoryDefault cmdlet resets one or both controllers to a factory default state. If you reset both controllers, you lose all data, metadata, and controller settings. The controllers revert to the operating system that the factory installed.

If you use Reset-HcsFactoryDefault to reset only one controller, that controller gets the current operating system image from its peer controller. You should reset only one controller if the peer controller is running and is in a healthy state. You do not lose any data if you reset only one controller.

The default behavior of this cmdlet is to reset both controllers.

Parameters

-Force

Forces the command to run without asking for user confirmation.

Aliases	none
Required?	false
Position?	named
Default Value	none
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-Format<String>

Specifies the format for how the shared serial-attached SCSI (SAS) disks where customer data is stored are formatted.

Aliases	none
Required?	false
Position?	1
Default Value	none
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-Scope<ClusterScope>

Specifies the scope. The acceptable values for this parameter are:

-- Cluster. Disable support access for both nodes. This option resets both controllers. This option loses all data. You must run setup again. This is the default.
-- Controller. Disable support access for the local node only. This option resets only the current controller. This option resets the current controller. That controller forms a cluster with the peer controller once the reset is complete. No data loss occurs in this process.

Aliases	none
Required?	false
Position?	2
Default Value	none
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

<CommonParameters>

This cmdlet supports the common parameters: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, and -OutVariable. For more information, see    about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).

Inputs

The input type is the type of the objects that you can pipe to the cmdlet.

Outputs

The output type is the type of the objects that the cmdlet emits.

Examples

Example 1: Reset both controllers to the default factory state

This command resets both controllers to the default factory state.

PS C:\> Reset-HCSFactoryDefault

Example 2: Reset both controllers to the factory default state without confirmation

This command resets both controllers to the factory default state. The user is not prompted for confirmation.

PS C:\> Reset-HCSFactoryDefault -Force

Example 3: Reset the current controller to the factory default state

This command resets the current controller to the factory default state.

PS C:\> Reset-HCSFactoryDefault -Scope Controller