|
|
 Data ONTAP® PowerShell Toolkit
|
Cmdlet: Set-NaVolAutosize
NAME
Set-NaVolAutosize
SYNOPSIS
Given the name of a flexible volume, set the autosize settings.
SYNTAX
Set-NaVolAutosize [-Name] <String> [-MinimumSize <String>] [-GrowThresholdPe
rcent <Int32>] [-ShrinkThresholdPercent <Int32>] [-Controller <NaController>
] [[-MaximumSize] <String>] [[-IncrementSize] <String>] [-EnableGrow] [<Comm
onParameters>]
Set-NaVolAutosize [-Name] <String> [-MinimumSize <String>] [-GrowThresholdPe
rcent <Int32>] [-ShrinkThresholdPercent <Int32>] [-Controller <NaController>
] [[-MaximumSize] <String>] [[-IncrementSize] <String>] [-Disabled] [<Common
Parameters>]
Set-NaVolAutosize [-Name] <String> [-MinimumSize <String>] [-GrowThresholdPe
rcent <Int32>] [-ShrinkThresholdPercent <Int32>] [-Controller <NaController>
] [[-MaximumSize] <String>] [[-IncrementSize] <String>] [-EnableGrowShrink]
[<CommonParameters>]
Set-NaVolAutosize [-Name] <String> [-Reset] [-Controller <NaController>] [<C
ommonParameters>]
DESCRIPTION
Given the name of a flexible volume, set the autosize settings.
PARAMETERS
-Name <String>
The name of the flexible volume for which we want to set autosize.
Required? true
Position? 1
Default value
Accept pipeline input? true (ByValue, ByPropertyName)
Accept wildcard characters? false
-MinimumSize <String>
The flexible volume's minimum allowed size in bytes. Specify the volume
minimum size using the following format:
[+|-]<number>[k|m|g|t|%]
If a leading '+' or '-' appears, it indicates that the volume minimum si
ze is to be increased or decreased (respectively) by the indicated amoun
t, else the amount is the absolute size to set. The optional trailing '
k', 'm', 'g', and 't' indicates the desired units, namely 'kilobytes', '
megabytes', 'gigabytes', and 'terabytes' (respectively). The optional t
railing '%' indicates to increase or decrease the size of the volume min
imum size by a percentage of its current value. If the trailing unit ch
aracter doesn't appear, then <number> is interpreted as the number of by
tes desired.
This parameter is present on Data ONTAP 8.2 and up.
Required? false
Position? named
Default value
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false
-GrowThresholdPercent <Int32>
Specifies the percentage of the flexible volume's capacity at which auto
grow is initiated. The default grow threshold varies from 85% to 98%, de
pending on the volume size. It is an error for the grow threshold to be
less than or equal to the shrink threshold.
This parameter is present on Data ONTAP 8.2 and up.
Required? false
Position? named
Default value
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false
-ShrinkThresholdPercent <Int32>
Specifies the percentage of the flexible volume's capacity at which auto
shrink is initiated. The default shrink threshold is 50%. It is an error
for the shrink threshold to be greater than or equal to the grow thresh
old.
This parameter is present on Data ONTAP 8.2 and up.
Required? false
Position? named
Default value
Accept pipeline input? true (ByPropertyName)
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
-MaximumSize <String>
The flexible volume's maximum allowed size in bytes. Specify the volume
maximum size using the following format:
[+|-]<number>[k|m|g|t|%]
If a leading '+' or '-' appears, it indicates that the volume maximum si
ze is to be increased or decreased (respectively) by the indicated amoun
t, else the amount is the absolute size to set. The optional trailing '
k', 'm', 'g', and 't' indicates the desired units, namely 'kilobytes', '
megabytes', 'gigabytes', and 'terabytes' (respectively). The optional t
railing '%' indicates to increase or decrease the size of the volume max
imum size by a percentage of its current value. If the trailing unit ch
aracter doesn't appear, then <number> is interpreted as the number of by
tes desired.
Required? false
Position? 2
Default value
Accept pipeline input? false
Accept wildcard characters? false
-IncrementSize <String>
The amount to increment the flexible volume's size in bytes. The format
to use is:
<number>[k|m|g|t]
where "k" means kilobytes, "m" means megabytes, "g" means gigabytes, and
"t" means terabytes. If no units are specified, the number is interpre
ted as the number of bytes. For example: 10g, 1.5tb, 20GB.
Required? false
Position? 3
Default value
Accept pipeline input? false
Accept wildcard characters? false
-EnableGrow
Specify to enable the volume grow autosize feature.
For Data ONTAP 8.2 and up, the autosize mode will be set to "grow".
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-Disabled
Specify to disable the volume autosize feature.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-EnableGrowShrink
Specify to enable the volume grow and shrink autosize feature. The volu
me autosize mode will be set to "grow_shrink".
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-Reset
Reset the MaximumSize, MinimumSize, IncrementSize, GrowThresholdPercent,
ShrinkThresholdPercent, and Mode of the volume autogrow to their defaul
t vaules.
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.Volume.VolumeInfo
NOTES
Category: volume
API: volume-autosize-set
-------------- Example 1 --------------
C:\PS>Set-NaVolAutosize vol2 -Enabled -MaximumSize 200g -IncrementSize 1g
Enable autosize on volume 'vol2'.
ChecksumStyle : block
CloneChildren :
CloneParent :
ContainingAggregate : aggr1
DiskCount : 8
FilesTotal : 6381567
FilesUsed : 201
IsChecksumEnabled : True
IsInconsistent : False
IsSnaplock : False
IsUnrecoverable : False
MirrorStatus : unmirrored
Name : vol2
PercentageUsed : 76
PlexCount : 1
Plexes : {/aggr1/plex0}
QuotaInit : 0
RaidSize : 16
RaidStatus : raid_dp,sis
Reserve : 10110808064
ReserveRequired : 10110808064
ReserveUsed : 0
Sis : idle
SizeAvailable : 46570201088
SizeTotal : 194347270144
SizeUsed : 147777069056
SnaplockType :
SpaceReserve : volume
SpaceReserveEnabled : True
State : online
Type : flex
Uuid : e91dc1f8-ab4f-11dd-867f-00a09806c227
IsUnrecoverableSpecified : True
PercentageUsedSpecified : True
SpaceReserveEnabledSpecified : True
-------------- Example 2 --------------
C:\PS>Get-NaVol | Set-NaVolAutosize -Enabled
Enable autosize on all volumes on the current controller.
-------------- Example 3 --------------
C:\PS>Set-NaVolAutoSize vol2 -MaximumSize +15%
Increase the volume maximum size by 15%.
ChecksumStyle : block
CloneChildren :
CloneParent :
ContainingAggregate : aggr1
DiskCount : 8
FilesTotal : 6381567
FilesUsed : 201
IsChecksumEnabled : True
IsInconsistent : False
IsSnaplock : False
IsUnrecoverable : False
MirrorStatus : unmirrored
Name : vol2
PercentageUsed : 76
PlexCount : 1
Plexes : {/aggr1/plex0}
QuotaInit : 0
RaidSize : 16
RaidStatus : raid_dp,sis
Reserve : 10110808064
ReserveRequired : 10110808064
ReserveUsed : 0
Sis : idle
SizeAvailable : 46570201088
SizeTotal : 194347270144
SizeUsed : 147777069056
SnaplockType :
SpaceReserve : volume
SpaceReserveEnabled : True
State : online
Type : flex
Uuid : e91dc1f8-ab4f-11dd-867f-00a09806c227
IsUnrecoverableSpecified : True
PercentageUsedSpecified : True
SpaceReserveEnabledSpecified : True
RELATED LINKS
Get-NaVolAutosize
| Copyright © 2013 NetApp. All rights reserved. Use is subject to license terms. |
|
Data ONTAP® PowerShell Toolkit
|