< Back

Reset-PhysicalDisk

Wed Jan 30, 2019 6:03 pm

NAME Reset-PhysicalDisk



SYNOPSIS

Resets the status of a physical disk.





SYNTAX

Reset-PhysicalDisk [-FriendlyName] <String> [-CimSession <CimSession>] [-ThrottleLimit <Int32>] [<CommonParameters>]



Reset-PhysicalDisk [-CimSession <CimSession>] [-ThrottleLimit <Int32>] -UniqueId <String> [<CommonParameters>]



Reset-PhysicalDisk [-CimSession <CimSession>] [-ThrottleLimit <Int32>] [<CommonParameters>]





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>]





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.



Required? true

Position? 1

Default value none

Accept pipeline input? true(ByValue)

Accept wildcard characters? false



-ThrottleLimit [<Int32>]





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.



Required? true

Position? named

Default value none

Accept pipeline input? true(ByValue)

Accept wildcard characters? false



<CommonParameters>

This cmdlet supports the common parameters: Verbose, Debug,

ErrorAction, ErrorVariable, WarningAction, WarningVariable,

OutBuffer, PipelineVariable, and OutVariable. For more information, see

about_CommonParameters (https:/go.microsoft.com/fwlink/?LinkID=113216).



INPUTS

Microsoft.Management.Infrastructure.CimInstance#ROOT/Microsoft/Windows/Storage/MSFT_PhysicalDisk

http://msdn.microsoft.com/library/windo ... 30532.aspx





The Microsoft.Management.Infrastructure.CimInstance object is a wrapper class that displays Windows Management Instrumentation (WMI) objects. The

path after the pound sign (#) provides the namespace and class name for the underlying WMI object.





OUTPUTS

Microsoft.Management.Infrastructure.CimInstance#ROOT/Microsoft/Windows/Storage/MSFT_PhysicalDisk

http://msdn.microsoft.com/library/windo ... 30532.aspx





The Microsoft.Management.Infrastructure.CimInstance object is a wrapper class that displays Windows Management Instrumentation (WMI) objects. The

path after the pound sign (#) provides the namespace and class name for the underlying WMI object.





EXAMPLE 1



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



This example resets the state of a specific physical disk.





EXAMPLE 2



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

PS C:\\> Reset-PhysicalDisk -FriendlyName $phydisk.FriendlyName



This example resets all of the unhealthy physical disks.







RELATED LINKS

Online Version: http://go.microsoft.com/fwlink/?LinkId=816471

Where-Object

Add-PhysicalDisk

Get-PhysicalDiskStorageNodeView

Remove-PhysicalDisk

Reset-PhysicalDisk