Data ONTAP® PowerShell Toolkit

Switch to Data ONTAP 7-mode documentation.

Cmdlet: New-NcSnapshot


NAME
New-NcSnapshot

SYNOPSIS
Create a new snapshot on a specified volume.

SYNTAX
New-NcSnapshot [-Volume] <String> [[-Snapshot] <String>] [-Async] [-Comment
<String>] [-VserverContext <String>] [-Controller <NcController[]>] [-WhatIf
] [-Confirm] [<CommonParameters>]


DESCRIPTION
Create a new snapshot on a specified volume.


PARAMETERS
-Volume <String>
Name of the volume on which the snapshot is to be created. The volume n
ame can contain letters, numbers, and the underscore character (_), but
the first character must be a letter or an underscore.

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

-Snapshot <String>
Name of the snapshot to be created. The maximum string length is 256 ch
aracters.

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

-Async
If specified, the snapshot is to be created asynchronously.

Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false

-Comment <String>
A human readable comment attached with the snapshot. The size of the co
mment can be at most 255 characters.

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

-VserverContext <String>
Vserver to which to direct this command. If the currently connected con
troller (as embodied by an NcController object) represents a cluster, th
ere are multiple means to address commands to one of its vservers. Eith
er set the Vserver field on the NcController object to direct all subseq
uent commands to that vserver, or supply the VserverContext parameter to
an individual cmdlet. Only cmdlets which may be invoked on vservers of
fer the VserverContext parameter.

Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false

-Controller <NcController[]>
A Data ONTAP cluster-mode controller to receive this cmdlet, as embodied
by an NcController object. This parameter is returned by the Connect-N
cController cmdlet. If not specified, the value in the global variable
CurrentNcController is used. In the latter case, if CurrentNcController
contains a collection of NcController objects, this cmdlet is invoked o
n each controller in succession.

Required? false
Position? named
Default value
Accept pipeline input? true (ByValue, ByPropertyName)
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
NetApp.Ontapi.Filer.C.Snapshot810.SnapshotInfo


NOTES


Category: snapshot
API: snapshot-create
Family: vserver

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

C:\PS>New-NcSnapshot vol2 snap1


Create a new snapshot 'snap1' of volume 'vol2'.


Name Volume Vserver Created Total Cumulative Dependency
---- ------ ------- ------- ----- ---------- ----------
snap1 vol2 vserver1 9/12/2011 68.0 KB 68.0 KB



RELATED LINKS
Get-NcSnapshot
Remove-NcSnapshot







 Data ONTAP® PowerShell Toolkit