|
|
 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] [-AllowMixedRpm] [-IgnorePoolChecks] [-PreCheck] [-ForceCacheSize]
[-CacheRaidType <String>] [-Controller <NaController>] [-RaidGroup <String>]
[<CommonParameters>]
Add-NaAggr [-Name] <String> -Disks <Object[]> [-ForceSparePool] [-MirrorDisk
s <Object[]>] [-AllowSameCarrier] [-AllowMixedRpm] [-IgnorePoolChecks] [-Pre
Check] [-ForceCacheSize] [-CacheRaidType <String>] [-Controller <NaControlle
r>] [-RaidGroup <String>] [<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
-AllowMixedRpm
If specified, disks in an aggregate are not required to have the same RP
M.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-IgnorePoolChecks
If specified, disks in a plex are not required to come from the same spa
re pool. Similarly, if specified, disks in different plexes of a mirror
ed aggregate are not required to come from different spare pools.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-PreCheck
If specified, check for warnings without actually adding the disks. If
any warnings are found, they are written to the pipeline as errors.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-ForceCacheSize
If specified, force the addition of SSD disks to hybrid enabled aggregat
e by skipping the check for total (local + partner) hybrid SSD capacity.
This can be used when the partner's cache capacity cannot be retrieved.
Warning: If specified, the administrator is responsible to ensure that t
he total limit will not be exceeded.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-CacheRaidType <String>
Specifies the raid-type of the new RAID groups being created as part of
the disk add operation. This option should be used while adding SSD disk
s for the first time to a hybrid-enabled aggregate. Possible values: rai
d4 and raid_dp only. If not specified, the default value is the raid-typ
e of the aggregate.
Required? false
Position? named
Default value
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
-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 © 2013 NetApp. All rights reserved. Use is subject to license terms. |
|
Data ONTAP® PowerShell Toolkit
|