|
|
 Data ONTAP® PowerShell Toolkit
|
Cmdlet: Set-NaDiskFail
NAME
Set-NaDiskFail
SYNOPSIS
Fail a file system disk.
SYNTAX
Set-NaDiskFail [-Name] <String> [-Immediate] [-Controller <NaController>] [-
WarningAction <ActionPreference>] [-WarningVariable <String>] [-WhatIf] [-Co
nfirm] [<CommonParameters>]
DESCRIPTION
Fail a file system disk. Removes the specified file system disk from the RAI
D configuration, spinning the disk down when removal is complete. disk fail
is used to remove a file system disk that may be logging excessive errors an
d requires replacement. Note that if optional input parameter 'is-immediate'
is true, the specified disk will be immediately failed out, and the RAID gr
oup to which the disk belongs will enter degraded mode (meaning a disk is mi
ssing from the RAID group). If a spare disk at least as large as the disk be
ing removed is available, the contents of the disk being removed will be rec
onstructed onto that spare disk. If 'is-immediate' options is false or not s
pecified, system will prefail the disk and its content will be copied to a r
eplacement disk if a suitable spare disk is available, and afterwards the pr
efailed disk will be failed out. This process can be observed by polling "Ge
t-NaDisk" for this disk and tracking values of elements copy-destination and
copy-percent. The disk being failed is marked as ``broken'', so that if it
remains in the disk shelf, it will not be used by the filer as a spare disk.
If the disk is moved to another filer, that filer will use it as a spare. T
his is not a recommended course of action, as the reason that the disk was f
ailed may have been because it needed to be replaced. NOTE: Data ONTAP 7.0 a
nd earlier releases don't indicate failure code properly.
PARAMETERS
-Name <String>
Name of the disk to fail, e.g. "v0.1".
Required? true
Position? 1
Default value
Accept pipeline input? true (ByValue, ByPropertyName)
Accept wildcard characters? false
-Immediate
Specify 'true' if disk is to be failed out immediately. If disk is to be
prefailed, specify 'false'. Default value is 'false'.
Required? false
Position? named
Default value false
Accept pipeline input? false
Accept wildcard characters? false
-Controller <NaController>
The DataONTAP controller object, embodied by an NaController object. Th
is parameter is returned by the Connect-NaController cmdlet. If not spe
cified, the value in the global variable CurrentNaController is used.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-WarningAction <ActionPreference>
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-WarningVariable <String>
Required? false
Position? named
Default value
Accept pipeline input? false
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
NetApp.Ontapi.Filer.Disk.DiskDetailInfo
NOTES
Category: disk
API: disk-fail
-------------- Example 1 --------------
C:\PS>Set-NaDiskFail 0a.28
Pre-fail file system disk '0a.28'.
Aggregate : aggr1
Bay : 12
BlocksRead : 276409408
BlocksWritten : 279805384
BrokenDetails :
BytesPerSector : 520
ChecksumCompatibility : zoned/block
CopyDestination :
CopyPercent :
DiskModel : X274_S10K7146F10
DiskType : FCAL
DiskUid : 20000018:6284A8D4:00000000:00000000:0000000
0:0
0000000:00000000:00000000:00000000:00000000
FirmwareRevision : NA07
GrownDefectListCount : 0
HostAdapter : 0a
Id : 1048577
IsDynamicallyQualified : False
IsOffline :
IsPrefailed : True
IsReplacing : False
IsZeroed :
Name : 0a.28
PhysicalBlocks : 280790184
PhysicalSpace : 143764574208
Plex : plex0
Pool : Pool0
Port : A
PortName : FC:A
PoweronHours : 18941
RaidGroup : rg0
RaidState : present
RaidType : data
RawDiskSectors : 280790184
ReconstructionPercent :
Rpm : 10000
ScrubCount : 28
ScrubLastDone : 49302
SecondaryName :
SecondaryPort :
SerialNumber : 3KS66RDP000097324ASA
Shelf : 1
ShmTimeInterval : 5189191
UsedBlocks : 278528000
UsedSpace : 142606336000
VSeriesDetailInfo :
VendorId : NETAPP
Volume :
ZeroingPercent :
CopyPercentSpecified : False
IsOfflineSpecified : False
IsPrefailedSpecified : True
IsReplacingSpecified : True
IsZeroedSpecified : False
PoweronHoursSpecified : True
ReconstructionPercentSpecified : False
RpmSpecified : True
ZeroingPercentSpecified : False
RELATED LINKS
Set-NaDiskUnfail
| Copyright © 2010 NetApp. All rights reserved. Use is subject to license terms. |
|
Data ONTAP® PowerShell Toolkit
|