Table of contents
TLS
TOC
Collapse the table of content
Expand the table of content

Enable-StorageMaintenanceMode

Last Updated: 3/8/2017

SYNOPSIS

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
Parameter Sets: (All)
Aliases: 

Required: False
Position: Named
Default value: None
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
Parameter Sets: (All)
Aliases: 

Required: False
Position: Named
Default value: None
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
Parameter Sets: (All)
Aliases: 

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

-InputObject

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

Type: CimInstance
Parameter Sets: (All)
Aliases: 

Required: True
Position: Named
Default value: None
Accept pipeline input: True (ByValue)
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
Parameter Sets: (All)
Aliases: 

Required: False
Position: Named
Default value: None
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
Parameter Sets: (All)
Aliases: 

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

-ValidateVirtualDisksHealthy

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

Type: Boolean
Parameter Sets: (All)
Aliases: 

Required: False
Position: Named
Default value: None
Accept pipeline input: False
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.

INPUTS

MSFT_StorageFaultDomain

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

OUTPUTS

NOTES

  • You can run this cmdlet only for fault domains that host resilient virtual disks, which include Mirror and Parity Space.

Disable-StorageMaintenanceMode

Get-PhysicalDisk

Get-StorageEnclosure

© 2017 Microsoft