|
|
 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 <Int32>] [-ForceSp
arePool] [-Controller <NaController>] [-RaidGroup <String>] [-WarningAction
<ActionPreference>] [-WarningVariable <String>] [-WhatIf] [-Confirm] [<Commo
nParameters>]
Add-NaAggr [-Name] <String> -Disks <Object[]> [-ForceSparePool] [-MirrorDisk
s <Object[]>] [-Controller <NaController>] [-RaidGroup <String>] [-WarningAc
tion <ActionPreference>] [-WarningVariable <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 <Int32>
The disk size in GB. Disks that are within approximately 20% of the spe
cified size will be selected for use in the aggregate. If not specified
, existing groups are appended with disks that are the best match for th
e largest disk in the group. When starting new groups, the smallest dis
ks are selected first. This option is ignored if a specific list of dis
ks to use is specified through the "disks" parameter. Range : [0..2^31-1
].
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 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
-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
-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
-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
<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.Aggr.AggrInfo
NOTES
Category: aggr
API: aggr-add
-------------- Add 5 disks automatically --------------
C:\PS>Add-NaAggr aggr1 -DiskCount 5
Adds five disks to aggregate 'aggr1'.
RELATED LINKS
New-NaAggr
Remove-NaAggr
Get-NaAggr
| Copyright © 2010 NetApp. All rights reserved. Use is subject to license terms. |
|
Data ONTAP® PowerShell Toolkit
|