Data ONTAP® PowerShell Toolkit

Switch to Data ONTAP Cluster-mode documentation.

Cmdlet: Set-NaPriorityVolume


NAME
Set-NaPriorityVolume

SYNOPSIS
Set priority scheduling for a volume.

SYNTAX
Set-NaPriorityVolume [-Volume] <String> [-Service <String>] [-Level <Int64>]
[-System <Int64>] [-UserReadLimit <Int64>] [-SystemReadLimit <Int64>] [-Nvl
ogLimit <Int64>] [-CachePolicy <String>] [-Controller <NaController>] [-What
If] [-Confirm] [<CommonParameters>]


DESCRIPTION
Set priority scheduling for a volume.


PARAMETERS
-Volume <String>
The volume whose priority scheduling is to be set.

Required? true
Position? 1
Default value
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false

-Service <String>
Sets the priority service type for the volume. The possible values are '
on', 'off' or 'default'. 'off' temporarily disables specific priority s
cheduling for the volume, but preserves the priority schedule so that it
can later be enabled. 'default' removes the specific priority scheduli
ng for the volume, which will revert to using the default priority sched
ule.

Required? false
Position? named
Default value
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false

-Level <Int64>
Sets the priority schedule level for the volume. The possible values ar
e 1 through 10, where 1 means lowest relative priority, and 10 means hig
hest relative priority.

Required? false
Position? named
Default value
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false

-System <Int64>
Sets the relative priority system/user scheduling for the volume. The p
ossible values are 1 through 10, where 1 means heavily favor user operat
ions and 10 means heavily favor system operations.

Required? false
Position? named
Default value
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false

-UserReadLimit <Int64>
The maximum number of user read operations outstanding before further op
erations are queued. A value of 0 means restore the system-defined limi
t.

Required? false
Position? named
Default value
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false

-SystemReadLimit <Int64>
The maximum number of system read operations outstanding before further
operations are queued. A value of 0 means restore the system-defined li
mit.

Required? false
Position? named
Default value
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false

-NvlogLimit <Int64>
The maximum percentage of system NVLOG resources that may be consumed.
A value of 0 means restore the system-defined limit.

Required? false
Position? named
Default value
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false

-CachePolicy <String>
The buffer cache policy to use for the volume. Possible values are:

'keep' - Try to keep data in the buffer cache
'reuse' - Reuse blocks, do not try to cache
'default' - Apply the default policy

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

-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

<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: priority
API: priority-set-volume

-------------- Example 1 --------------

C:\PS>Set-NaPriorityVolume vol1 -Service on -Level 6 -System 3 -UserReadLimi
t 48 -SystemReadLimit 16 -NvlogLimit 10 -CachePolicy keep


Configure the priority schedule for volume 'vol1'.


DedupeEnabled : True
ChecksumStyle : block
CloneChildren : {vol1clone}
CloneParent :
ContainingAggregate : aggr1
DiskCount : 8
FilesTotal : 622580
FilesUsed : 142
IsChecksumEnabled : True
IsInconsistent : False
IsSnaplock : False
IsUnrecoverable : False
MirrorStatus : unmirrored
Name : vol1
PercentageUsed : 5
PlexCount : 1
Plexes : {/aggr1/plex0}
QuotaInit : 0
RaidSize : 16
RaidStatus : raid_dp,sis
Reserve : 0
ReserveRequired : 0
ReserveUsed : 0
Sis : idle
SizeAvailable : 16331317248
SizeTotal : 17179869184
SizeUsed : 848551936
SnaplockType :
SpaceReserve : volume
SpaceReserveEnabled : True
State : online
Type : flex
Uuid : eaf2a090-48a4-11df-a07f-00a09806c227
IsUnrecoverableSpecified : True
PercentageUsedSpecified : True
SpaceReserveEnabledSpecified : True


-------------- Example 2 --------------

C:\PS>Get-NaPriorityVolume vol0 | Set-NaPriorityVolume -Volume vol1


Copy priority settings from volume 'vol0' to volume 'vol1'.


DedupeEnabled : True
ChecksumStyle : block
CloneChildren : {vol1clone}
CloneParent :
ContainingAggregate : aggr1
DiskCount : 8
FilesTotal : 622580
FilesUsed : 142
IsChecksumEnabled : True
IsInconsistent : False
IsSnaplock : False
IsUnrecoverable : False
MirrorStatus : unmirrored
Name : vol1
PercentageUsed : 5
PlexCount : 1
Plexes : {/aggr1/plex0}
QuotaInit : 0
RaidSize : 16
RaidStatus : raid_dp,sis
Reserve : 0
ReserveRequired : 0
ReserveUsed : 0
Sis : idle
SizeAvailable : 16331317248
SizeTotal : 17179869184
SizeUsed : 848551936
SnaplockType :
SpaceReserve : volume
SpaceReserveEnabled : True
State : online
Type : flex
Uuid : eaf2a090-48a4-11df-a07f-00a09806c227
IsUnrecoverableSpecified : True
PercentageUsedSpecified : True
SpaceReserveEnabledSpecified : True


-------------- Example 3 --------------

C:\PS>Set-NaPriorityVolume vol1 -Service default


Remove the priority schedule entry for volume 'vol1'.


DedupeEnabled : True
ChecksumStyle : block
CloneChildren : {vol1clone}
CloneParent :
ContainingAggregate : aggr1
DiskCount : 8
FilesTotal : 622580
FilesUsed : 142
IsChecksumEnabled : True
IsInconsistent : False
IsSnaplock : False
IsUnrecoverable : False
MirrorStatus : unmirrored
Name : vol1
PercentageUsed : 5
PlexCount : 1
Plexes : {/aggr1/plex0}
QuotaInit : 0
RaidSize : 16
RaidStatus : raid_dp,sis
Reserve : 0
ReserveRequired : 0
ReserveUsed : 0
Sis : idle
SizeAvailable : 16331317248
SizeTotal : 17179869184
SizeUsed : 848551936
SnaplockType :
SpaceReserve : volume
SpaceReserveEnabled : True
State : online
Type : flex
Uuid : eaf2a090-48a4-11df-a07f-00a09806c227
IsUnrecoverableSpecified : True
PercentageUsedSpecified : True
SpaceReserveEnabledSpecified : True



RELATED LINKS
Get-NaPriorityVolume







 Data ONTAP® PowerShell Toolkit