Data ONTAP® PowerShell Toolkit

Switch to Data ONTAP Cluster-mode documentation.

Cmdlet: New-NaSnapshot


NAME
New-NaSnapshot

SYNOPSIS
Create a new snapshot on a specified volume or aggregate.

SYNTAX
New-NaSnapshot [-TargetName] <String> [[-SnapName] <String>] [-TargetType <S
tring>] [-Async] [-Controller <NaController>] [-WhatIf] [-Confirm] [<CommonP
arameters>]


DESCRIPTION
Create a new snapshot on a specified volume or aggregate.


PARAMETERS
-TargetName <String>
Name of the volume or aggregate on which the snapshot is to be created.

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

-SnapName <String>
Name of the snapshot to be created. If not specified, a GUID-style name
will be autogenerated.

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

-TargetType <String>
Specify the type of snapshot target, either "volume" or "aggregate".

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

-Async
If true, the snapshot is to be created asynchronously. The default valu
e is false. Applies only to volume snapshots.

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

-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.Snapshot.SnapshotInfo


NOTES


Category: snapshot
API: snapshot-create, system-cli
Privilege: security-priv-admin, api-snap-create

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

C:\PS>New-NaSnapshot vol2 vol2snap


Create a new snapshot of volume 'vol2' named 'vol2snap'.


Created : 3/11/2011 9:09:59 PM
Cumulative :
AccessTime : 1299877799
AccessTimeDT : 3/11/2011 9:09:59 PM
Busy : False
CumulativePercentageOfTotalBlocks : 0
CumulativePercentageOfUsedBlocks : 0
CumulativeTotal :
Dependency :
Name : vol2snap
PercentageOfTotalBlocks : 0
PercentageOfUsedBlocks : 0
SnapshotOwnersList :
TargetName : vol2
TargetType : volume
Total :



RELATED LINKS
Get-NaSnapshot
Remove-NaSnapshot
Restore-NaSnapshotVolume







 Data ONTAP® PowerShell Toolkit