|
|
 Data ONTAP® PowerShell Toolkit
|
Cmdlet: Set-NcDiskFail
NAME
Set-NcDiskFail
SYNOPSIS
Fail a file system disk.
SYNTAX
Set-NcDiskFail [-Name] <String> [-Immediate] [-Controller <NcController[]>]
[-WhatIf] [-Confirm] [<CommonParameters>]
DESCRIPTION
Fail a file system disk. Removes the specified file system disk from the RA
ID configuration, spinning the disk down when removal is complete. Disk fai
l is used to remove a file system disk that may be logging excessive errors
and requires replacement. Note that if optional input parameter -Immediate
is specified, the specified disk will be immediately failed out, and the RAI
D group to which the disk belongs will enter degraded mode (meaning a disk i
s missing from the RAID group). If a spare disk at least as large as the di
sk being removed is available, the contents of the disk being removed will b
e reconstructed onto that spare disk. If -Immediate is not specified, syste
m will prefail the disk and its content will be copied to a replacement disk
if a suitable spare disk is available, and afterwards the prefailed disk wi
ll be failed out. The disk being failed is marked as 'broken', so that if i
t remains in the disk shelf, it will not be used by the filer as a spare dis
k. If the disk is moved to another filer, that filer will use it as a spare
. This is not a recommended course of action, as the reason that the disk w
as failed may have been because it needed to be replaced.
To fail a spare disk, use Remove-NcDisk.
PARAMETERS
-Name <String>
The name of the RAID disk to fail. The disk name should use the format
"<Node Name>:<Disk Name>", such as "VxeRubble-01:1a.02.23".
Required? true
Position? 1
Default value
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false
-Immediate
Specify if disk is to be failed out immediately. If not specified, the
disk will be prefailed.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-Controller <NcController[]>
A clustered Data ONTAP controller to receive this cmdlet, as embodied by
an NcController object. This parameter is returned by the Connect-NcCo
ntroller cmdlet. If not specified, the value in the global variable Cur
rentNcController is used. In the latter case, if CurrentNcController co
ntains a collection of NcController objects, this cmdlet is invoked on e
ach controller in succession.
Required? false
Position? named
Default value
Accept pipeline input? true (ByValue, ByPropertyName)
Accept wildcard characters? false
-WhatIf
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-Confirm
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer and OutVariable. For more information, type,
"get-help about_commonparameters".
INPUTS
OUTPUTS
DataONTAP.C.Types.StorageDisk.StorageDiskInfo
NOTES
Category: disk
API: disk-fail
Family: cluster
-------------- Example 1 --------------
C:\PS>Set-NcDiskFail fas3070cluster01-01:0a.17
Fail RAID disk '0a.17' on node 'fas3070cluster01-01'.
DiskName : fas3070cluster01-01:0a.17
NcController : 10.61.172.155
Name : fas3070cluster01-01:0a.17
DiskInventoryInfo : DataONTAP.C.Types.StorageDisk.DiskInventoryInfo
DiskOwnershipInfo : DataONTAP.C.Types.StorageDisk.DiskOwnershipInfo
DiskPaths : {fas3070cluster01-01:0a.17, fas3070cluster01-02:0a.17}
DiskRaidInfo : DataONTAP.C.Types.StorageDisk.DiskRaidInfo
DiskStatsInfo : DataONTAP.C.Types.StorageDisk.DiskStatsInfo
DiskUid : 20000018:6232F7F7:00000000:00000000:00000000:00000000:00
000000:00000000:00000000:00000000
Bay :
Shelf :
Position : dparity
Capacity : 146010895680
RPM : 15000
Paths : 2
Pool : 0
FW : NA02
Model : X275_S15K4146F15
Aggregate : aggr0
RELATED LINKS
Remove-NcDisk
Set-NcDiskUnfail
Get-NcDisk
| Copyright © 2012 NetApp. All rights reserved. Use is subject to license terms. |
|
Data ONTAP® PowerShell Toolkit
|