Reset-PhysicalDisk

Reset-PhysicalDisk

Resets the status of a physical disk.

Syntax

Parameter Set: ByName
Reset-PhysicalDisk [-FriendlyName] <String> [-CimSession <CimSession> ] [-ThrottleLimit <Int32> ] [ <CommonParameters>] [ <WorkflowParameters>]

Parameter Set: ByInputObject
Reset-PhysicalDisk [-CimSession <CimSession> ] [-ThrottleLimit <Int32> ] [ <CommonParameters>] [ <WorkflowParameters>]

Parameter Set: ByUniqueId
Reset-PhysicalDisk -UniqueId <String> [-CimSession <CimSession> ] [-ThrottleLimit <Int32> ] [ <CommonParameters>] [ <WorkflowParameters>]




Detailed Description

The Reset-PhysicalDisk cmdlet resets the status of a physical disk. For Storage spaces, this is a destructive operation that removes the Storage pool configuration and pool data from the specified physical disk.

If you run Reset-PhysicalDisk on a physical disk that appears as lost communication or split, this cmdlet attempts to re-integrate the disk into the Storage pool if the disk is discoverable. After you reset a physical disk, use Repair-VirtualDisk to restore its resiliency.

If you run Reset-PhysicalDisk on a disk that is not a part of a Storage pool, the operation clears any lingering Storage spaces data and metadata.

Parameters

-CimSession<CimSession>

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-FriendlyName<String>

Specifies a friendly name for a disk. The friendly name may be defined by a user and is not guaranteed to be unique.


Aliases

none

Required?

true

Position?

1

Default Value

none

Accept Pipeline Input?

true(ByValue)

Accept Wildcard Characters?

false

-ThrottleLimit<Int32>

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-UniqueId<String>

Specifies an ID used to uniquely identify a Disk object in the system. The ID persists through restarts.


Aliases

Id

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

true(ByValue)

Accept Wildcard Characters?

false

<CommonParameters>

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

<WorkflowParameters>

This cmdlet supports the following workflow common parameters: -PSParameterCollection, -PSComputerName, -PSCredential, -PSConnectionRetryCount, -PSConnectionRetryIntervalSec, -PSRunningTimeoutSec, -PSElapsedTimeoutSec, -PSPersist, -PSAuthentication, -PSAuthenticationLevel, -PSApplicationName, -PSPort, -PSUseSSL, -PSConfigurationName, -PSConnectionURI, -PSAllowRedirection, -PSSessionOption, -PSCertificateThumbprint, -PSPrivateMetadata, -AsJob, -JobName, and –InputObject. For more information, see    about_WorkflowCommonParameters.

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

This example resets the state of a specific physical disk.


PS C:\> Reset-PhysicalDisk -FriendlyName "PhysicalDisk5"

EXAMPLE 2

This example resets all of the unhealthy physical disks.


PS C:\> $phydisk = (Get-Physicaldisk | Where-Object –FilterScript {$_.HealthStatus -Eq "Unhealthy"}
PS C:\> Reset-PhysicalDisk -FriendlyName $phydisk.FriendlyName

Related topics

Community Additions

ADD
Show: