|
|
 Data ONTAP® PowerShell Toolkit
|
Cmdlet: Add-NaAggr
NAME
Add-NaAggr
SYNOPSIS
Add disks to the specified aggregate.
SYNTAX
Add-NaAggr [-Name] <String> -DiskCount <Int32> [-DiskSize <Int64>] [-ForceSp
arePool] [-Controller <NaController>] [-RaidGroup <String>] [-WhatIf] [-Conf
irm] [<CommonParameters>]
Add-NaAggr [-Name] <String> -Disks <Object[]> [-ForceSparePool] [-MirrorDisk
s <Object[]>] [-AllowSameCarrier] [-Controller <NaController>] [-RaidGroup <
String>] [-WhatIf] [-Confirm] [<CommonParameters>]
DESCRIPTION
Add disks to the specified aggregate, whether it is free-standing or embedde
d in a traditional volume. The disks to add are specified in the same way as
for "New-NaAggr". Disks cannot be added to a mirrored aggregate if one or
more of the plexes is offline. By the time the API returns, the disk(s) may
not yet be completely added. Use "Get-NaAggr" to query the aggregate status
to determine when it has finished growing due to the added disk(s).
PARAMETERS
-Name <String>
Name of the aggregate to which the disks will be added.
Required? true
Position? 1
Default value
Accept pipeline input? true (ByValue, ByPropertyName)
Accept wildcard characters? false
-DiskCount <Int32>
Number of disks to add, including the parity disks. The disks will come
from the pool of spare disks. The smallest disks in this pool join the a
ggregate first, unless the "DiskSize" argument is specified. Either the
"DiskCount" or "Disks" argument must be specified. Range : [0..2^31-1].
Required? true
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-DiskSize <Int64>
The disk size in bytes. Disks that are within approximately 20% of the
specified size will be selected for use in the aggregate. If not specif
ied, existing groups are appended with disks that are the best match for
the largest disk in the group. When starting new groups, the smallest
disks are selected first. This option is ignored if a specific list of
disks to use is specified through the "disks" parameter.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-ForceSparePool
Disks in a plex are not normally permitted to span spare pools. This be
havior is overridden with this option when it is set to "true".
Required? false
Position? named
Default value false
Accept pipeline input? false
Accept wildcard characters? false
-Controller <NaController>
The Data ONTAP controller object, embodied by an NaController object. T
his parameter is returned by the Connect-NaController cmdlet. If not sp
ecified, the value in the global variable CurrentNaController is used.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-RaidGroup <String>
Specifies the RAID group (for example rg0) to which the indicated disks
are to be added. When a RAID group other than the last RAID group is s
pecified, the aggregate can no longer be reverted to a version of ONTAP
prior to 6.2. In such a case, the "ForceSparePool" option must be speci
fied as well.
By default, the filer fills up one RAID group with disks before starting
another RAID group. Suppose an aggregate currently has one RAID group
of 12 disks and its RAID group size is 14. If you add 5 disks to this a
ggregate, it will have one RAID group with 14 disks and another RAID gro
up with 3 disks. The filer does not evenly distribute disks among RAID
groups.
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
-Disks <Object[]>
Specific list of disks to add to the aggregate. If the aggregate is mirr
ored and a specific list of disks is supplied, another list ("MirrorDisk
s") must also be supplied with the same number of disks. Either the "Dis
k" or "DiskCount" argument must be specified.
Required? true
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-MirrorDisks <Object[]>
Specific list of mirror disks needed to accompany the list in the "Disks
" parameter. This list must contain the same number of disks as specifi
ed in "Disks".
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-AllowSameCarrier
If specified, allows placing two disks from one carrier in one RAID grou
p.
Using two disks from one carrier that houses multiple disks in one RAID
group is not desirable. If that happens, Data ONTAP initiates a series o
f disk copy operations to correct that situation. Sometimes, selection o
f available spare disks makes it impossible to avoid placing two disks f
rom one carrier in one RAID group. Setting this option to true allows pl
acing two disks from one carrier in one RAID group. This option is only
available when specifying specific disks using the Disks parameter.
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.Types.Aggr.AggrInfo
NOTES
Category: aggr
API: aggr-add
-------------- Add 2 disks automatically --------------
C:\PS>Add-NaAggr aggr1 -DiskCount 2 -DiskSize 73gb
Adds two additional 73 GB disks to aggregate 'aggr1'.
BlockType :
ChecksumStatus : active
ChecksumStyle : block
DiskCount : 3
FilesTotal : 31142
FilesUsed : 98
IsChecksumEnabled : True
IsInconsistent : False
IsSnaplock : False
MirrorStatus : unmirrored
Name : aggr1
PlexCount : 1
Plexes : {/aggr1/plex0}
RaidSize : 16
RaidStatus : raid_dp,growing
SizeAvailable : 60945756160
SizePercentageUsed : 0
SizeTotal : 60945833984
SizeUsed : 77824
SnaplockType :
State : online
Type : aggr
Uuid : 723cf282-9019-11df-b5ca-00a098052d0c
VolumeCount : 0
Volumes : {}
SizePercentageUsedSpecified : True
RELATED LINKS
New-NaAggr
Remove-NaAggr
Get-NaAggr
| Copyright © 2012 NetApp. All rights reserved. Use is subject to license terms. |
|
Data ONTAP® PowerShell Toolkit
|