< Back
Enable-StorageMaintenanceMode
Post
NAME Enable-StorageMaintenanceMode
SYNOPSIS
Enables storage maintenance mode on a device.
SYNTAX
Enable-StorageMaintenanceMode [-CimSession <CimSession>] [-IgnoreDetachedVirtualDisks] [-Manufacturer <String>] [-Model <String>]
[-ValidateVirtualDisksHealthy <Nullable [System.Boolean]>] [<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.
PARAMETERS
-CimSession [<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.
Required? false
Position? named
Default value none
Accept pipeline input? false
Accept wildcard characters? false
-IgnoreDetachedVirtualDisks [<SwitchParameter>]
Indicates that this cmdlet ignores detached virtual disks when it performs the criticality check for last data-copy and other health metrics.
Required? false
Position? named
Default value none
Accept pipeline input? false
Accept wildcard characters? false
-Manufacturer [<String>]
Specifies the manufacturer of a device. This cmdlet matches manufacturer information of physical disk devices, and places those devices in
maintenance mode.
Required? false
Position? named
Default value none
Accept pipeline input? false
Accept wildcard characters? false
-Model [<String>]
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.
Required? false
Position? named
Default value none
Accept pipeline input? false
Accept wildcard characters? false
-ValidateVirtualDisksHealthy [<Nullable [System.Boolean]>]
Indicates whether this cmdlet validates that all vitural disks in the fault domain to be placed in maintenance mode are healthy before it proceeds.
Required? false
Position? named
Default value none
Accept pipeline input? false
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
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.
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.
RELATED LINKS
Online Version: http://go.microsoft.com/fwlink/?LinkId=812152
Disable-StorageMaintenanceMode
Get-PhysicalDiskStorageNodeView
Get-StorageEnclosureStorageNodeView
SYNOPSIS
Enables storage maintenance mode on a device.
SYNTAX
Enable-StorageMaintenanceMode [-CimSession <CimSession>] [-IgnoreDetachedVirtualDisks] [-Manufacturer <String>] [-Model <String>]
[-ValidateVirtualDisksHealthy <Nullable [System.Boolean]>] [<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.
PARAMETERS
-CimSession [<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.
Required? false
Position? named
Default value none
Accept pipeline input? false
Accept wildcard characters? false
-IgnoreDetachedVirtualDisks [<SwitchParameter>]
Indicates that this cmdlet ignores detached virtual disks when it performs the criticality check for last data-copy and other health metrics.
Required? false
Position? named
Default value none
Accept pipeline input? false
Accept wildcard characters? false
-Manufacturer [<String>]
Specifies the manufacturer of a device. This cmdlet matches manufacturer information of physical disk devices, and places those devices in
maintenance mode.
Required? false
Position? named
Default value none
Accept pipeline input? false
Accept wildcard characters? false
-Model [<String>]
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.
Required? false
Position? named
Default value none
Accept pipeline input? false
Accept wildcard characters? false
-ValidateVirtualDisksHealthy [<Nullable [System.Boolean]>]
Indicates whether this cmdlet validates that all vitural disks in the fault domain to be placed in maintenance mode are healthy before it proceeds.
Required? false
Position? named
Default value none
Accept pipeline input? false
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
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.
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.
RELATED LINKS
Online Version: http://go.microsoft.com/fwlink/?LinkId=812152
Disable-StorageMaintenanceMode
Get-PhysicalDiskStorageNodeView
Get-StorageEnclosureStorageNodeView