Data ONTAP® PowerShell Toolkit

Switch to Data ONTAP Cluster-mode documentation.

Cmdlet: Set-NaVolAutosize


NAME
Set-NaVolAutosize

SYNOPSIS
Given the name of a flexible volume, set the autosize settings.

SYNTAX
Set-NaVolAutosize [-Name] <String> [-Controller <NaController>] [[-MaximumSi
ze] <String>] [[-IncrementSize] <String>] [-Enabled] [-WhatIf] [-Confirm] [<
CommonParameters>]

Set-NaVolAutosize [-Name] <String> [-Controller <NaController>] [[-MaximumSi
ze] <String>] [[-IncrementSize] <String>] [-Disabled] [-WhatIf] [-Confirm] [
<CommonParameters>]


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

-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

-Enabled
Specify to enable the volume autosize feature.

Required? false
Position? named
Default value false
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

-Disabled
Specify to disable the volume autosize feature.

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







 Data ONTAP® PowerShell Toolkit