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).
Related Links
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour