Redigera

Dela via


Enable-StorageMaintenanceMode

Enables storage maintenance mode on a device.

Syntax

Enable-StorageMaintenanceMode
      -InputObject <CimInstance>
      [-IgnoreDetachedVirtualDisks]
      [-ValidateVirtualDisksHealthy <Boolean>]
      [-Model <String>]
      [-Manufacturer <String>]
      [-CimSession <CimSession>]
      [-AsJob]
      [<CommonParameters>]

Description

The Enable-StorageMaintenanceMode cmdlet enables storage maintenance mode on a PhysicalDisk device.

You can use this cmdlet on storage fault domains, which include PhysicalDisk, Enclosure, and SSU, that are part of a Storage Spaces pool or virtual disk. While a device is in maintenance mode, no input/output operations flow to that device. Instead, if other fault domains are available and configured, other fault domains serve input/output commands. If enabling storage maintenance mode takes the last copy of data offline for a virtual disk, this cmdlet does not enable maintenance mode.

Examples

Example 1: Enable maintenance mode on a physical disk

PS C:\>Get-PhysicalDisk -FriendlyName "Disk22" | Enable-StorageMaintenanceMode

This command gets a physical disk by using the Get-PhysicalDisk cmdlet, and then passes that object to the current cmdlet. The command enables storage maintenance mode on the disk named Disk22.

Example 2: Enable maintenance mode on an enclosure

PS C:\>Get-StorageEnclosure -FriendlyName "Enclosure17" | Enable-StorageMaintenanceMode

This command gets a storage enclosure disk by using the Get-StorageEnclosure cmdlet, and then passes that object to the current cmdlet. The command enables storage maintenance mode on the enclosure named Enclosure17.

Parameters

-AsJob

Runs the cmdlet as a background job. Use this parameter to run commands that take a long time to complete.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-CimSession

Runs the cmdlet in a remote session or on a remote computer. Enter a computer name or a session object, such as the output of a New-CimSession or Get-CimSession cmdlet. The default is the current session on the local computer.

Type:CimSession
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-IgnoreDetachedVirtualDisks

Indicates that this cmdlet ignores detached virtual disks when it performs the criticality check for last data-copy and other health metrics.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-InputObject

Specifies the input object that is used in a pipeline command.

Type:CimInstance
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Manufacturer

Specifies the manufacturer of a device. This cmdlet matches manufacturer information of physical disk devices, and places those devices in maintenance mode.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Model

Specifies the model of a physical disk device that this cmdlet places in maintenance mode. If multiple devices fit a model string, this cmdlet places those devices in maintenance mode.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ValidateVirtualDisksHealthy

Indicates whether this cmdlet validates that all virtual disks in the fault domain to be placed in maintenance mode are healthy before it proceeds.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Inputs

MSFT_StorageFaultDomain

You can pipe a fault domain object, PhysicalDisk, Enclosure, or SSU to this cmdlet.

Notes

  • You can run this cmdlet only for fault domains that host resilient virtual disks, which include Mirror and Parity Space.
  • When used in Failover Cluster, cmdlets from the Storage module operate on cluster level (all servers in the cluster).