0% found this document useful (0 votes)

1K views83 pages

Making The Most of Data ONTAP PowerShell Toolkit

The document discusses release notes and new features for multiple versions of the Data ONTAP PowerShell Toolkit. It describes enhancements, new cmdlets, and issues fixed for versions 3.2.1, 3.2, 3.1, 3.0, 2.4, 2.3, 2.2, 2.1, and 2.0 of the toolkit.

Uploaded by

lucky526526

We take content rights seriously. If you suspect this is your content, claim it here.

Available Formats

Download as PDF, TXT or read online on Scribd

0% found this document useful (0 votes)

1K views83 pages

Making The Most of Data ONTAP PowerShell Toolkit

Uploaded by

lucky526526

We take content rights seriously. If you suspect this is your content, claim it here.

Available Formats

Download as PDF, TXT or read online on Scribd

Making the Most of the Data ONTAP PowerShell Toolkit

Welcome
Thank you for using the Data ONTAP PowerShell Toolkit! We are committed to continuous improvement of our
PowerShell solution. Please keep the great suggestions coming.
If you are new to the Toolkit, see our Getting Started slides. If you are considering embedding PowerShell in a larger
.NET application, see our C# PowerShell embedding example or check out the Data ONTAP PowerShell Toolkit Proxy DLL.

Contents
Making the Most of the Data ONTAP PowerShell Toolkit ...................................................................................................... 1
Welcome ................................................................................................................................................................................. 1
Data ONTAP PowerShell Toolkit 3.2.1 .................................................................................................................................... 6
Full Data ONTAP 8.3 API support ........................................................................................................................................ 6
Other enhancements .......................................................................................................................................................... 6
New cmdlets ....................................................................................................................................................................... 6
Issues Fixed ......................................................................................................................................................................... 8
Data ONTAP PowerShell Toolkit 3.2 ....................................................................................................................................... 8
Data ONTAP 8.3 API support ............................................................................................................................................... 8
Other enhancements .......................................................................................................................................................... 9
New Cmdlets ....................................................................................................................................................................... 9
Issues Fixed ....................................................................................................................................................................... 10
Data ONTAP PowerShell Toolkit 3.1 ..................................................................................................................................... 10
Perfstat data collection ..................................................................................................................................................... 10
Full Data ONTAP 8.2.1 API support ................................................................................................................................... 11
Other enhancements ........................................................................................................................................................ 12
New Cmdlets ..................................................................................................................................................................... 16
Issues Fixed ....................................................................................................................................................................... 16
Data ONTAP PowerShell Toolkit 3.0 ..................................................................................................................................... 17
Sysstat for clustered Data ONTAP..................................................................................................................................... 17
Full Data ONTAP 8.2 API support ...................................................................................................................................... 18

Other Enhancements ........................................................................................................................................................ 19

New Cmdlets ..................................................................................................................................................................... 20
Issues Fixed ....................................................................................................................................................................... 21
Data ONTAP PowerShell Toolkit 2.4 ..................................................................................................................................... 21
Virtual Disk Space Reclamation......................................................................................................................................... 21
VMDK to VHD/VHDX with IDE driver injection for Windows Server 2003 ....................................................................... 22
Data ONTAP 8.2 API Support ............................................................................................................................................ 22
Other Enhancements ........................................................................................................................................................ 25
New Cmdlets ..................................................................................................................................................................... 26
Issues Fixed ....................................................................................................................................................................... 26
Data ONTAP PowerShell Toolkit 2.3 ..................................................................................................................................... 26
VSS Requester ................................................................................................................................................................... 26
Installer ............................................................................................................................................................................. 28
SCSI XCOPY ........................................................................................................................................................................ 28
Private Key Authentication for SSH................................................................................................................................... 29
Simplified Queries with PowerShell 3 ............................................................................................................................... 29
Other Enhancements ........................................................................................................................................................ 30
Issues Fixed ....................................................................................................................................................................... 31
Data ONTAP PowerShell Toolkit 2.2 ..................................................................................................................................... 31
VHDX Support ................................................................................................................................................................... 31
IPv6 Support ...................................................................................................................................................................... 32
Storage Efficiency Calculations for Cluster-Mode............................................................................................................. 33
PowerShell Toolkit Proxy Layer ......................................................................................................................................... 34
Other Enhancements ........................................................................................................................................................ 35
New Cmdlets ..................................................................................................................................................................... 36
Issues Fixed ....................................................................................................................................................................... 36
Data ONTAP PowerShell Toolkit 2.1 ..................................................................................................................................... 36
Stable output types ........................................................................................................................................................... 36

Sub-LUN cloning a Windows file out of a snapshot .......................................................................................................... 37

Complete Data ONTAP 8.1 coverage ................................................................................................................................ 37
Other enhancements ........................................................................................................................................................ 37
New cmdlets ..................................................................................................................................................................... 38
Issues fixed in Toolkit 2.1 .................................................................................................................................................. 39
Data ONTAP PowerShell Toolkit 2.0 ..................................................................................................................................... 40
Data ONTAP 8.1 Cluster-Mode ......................................................................................................................................... 40
Dynamic VHD file to thin, fixed VHD file conversion ........................................................................................................ 40
LUN to VHD file conversion ............................................................................................................................................... 41
VHD file to LUN conversion ............................................................................................................................................... 41
NDMP copy client.............................................................................................................................................................. 41
More complete support for CIFS shares ........................................................................................................................... 42
Installation scripts ............................................................................................................................................................. 42
Other enhancements ........................................................................................................................................................ 42
New cmdlets ..................................................................................................................................................................... 43
Issues fixed in Toolkit 2.0 .................................................................................................................................................. 44
Data ONTAP PowerShell Toolkit 1.7 ..................................................................................................................................... 45
V2V utilities ....................................................................................................................................................................... 45
VHD file alignment ............................................................................................................................................................ 45
Data ONTAP 8.1 (Cluster-Mode) ....................................................................................................................................... 45
File cloning for CIFS ........................................................................................................................................................... 47
Space reclamation for Cluster Shared Volumes................................................................................................................ 47
Other enhancements ........................................................................................................................................................ 47
New cmdlets ..................................................................................................................................................................... 49
Issues fixed in Toolkit 1.7 .................................................................................................................................................. 49
Data ONTAP PowerShell Toolkit 1.6 ..................................................................................................................................... 50
VHD file utilities ................................................................................................................................................................ 50
Space reclamation............................................................................................................................................................. 51

Windows disk and volume management.......................................................................................................................... 51

File cloning ........................................................................................................................................................................ 53
SSH setup .......................................................................................................................................................................... 53
Vfiler migration ................................................................................................................................................................. 53
More complete API coverage............................................................................................................................................ 53
Data ONTAP 8.1 (Cluster-Mode) ....................................................................................................................................... 53
Other enhancements ........................................................................................................................................................ 55
New cmdlets ..................................................................................................................................................................... 56
Issues fixed in Toolkit 1.6 .................................................................................................................................................. 57
Data ONTAP PowerShell Toolkit 1.5 ..................................................................................................................................... 58
Storage efficiency calculations.......................................................................................................................................... 58
Host-side iSCSI & FC utilities ............................................................................................................................................. 59
ONTAP log parsing and monitoring................................................................................................................................... 61
Disk signature manipulation ............................................................................................................................................. 62
Faster host disk & VM discovery ....................................................................................................................................... 62
Vfiler DR ............................................................................................................................................................................ 63
SnapLock ........................................................................................................................................................................... 63
Secure password handling ................................................................................................................................................ 63
Other enhancements ........................................................................................................................................................ 63
New cmdlets ..................................................................................................................................................................... 64
Issues fixed in Toolkit 1.5 .................................................................................................................................................. 64
Data ONTAP PowerShell Toolkit 1.4 ..................................................................................................................................... 65
Sysstat ............................................................................................................................................................................... 65
Updated Data ONTAP support .......................................................................................................................................... 69
New cmdlet categories ..................................................................................................................................................... 69
Improved error handling ................................................................................................................................................... 69
Simpler quota cmdlets ...................................................................................................................................................... 69
Improved snapshot cmdlets.............................................................................................................................................. 70

Improved cluster support in Get-NaHyperV ..................................................................................................................... 70

API list cmdlets .................................................................................................................................................................. 71
Raw API invocation ........................................................................................................................................................... 71
Hashed options ................................................................................................................................................................. 71
Provider enhancements .................................................................................................................................................... 72
Table column header aliases ............................................................................................................................................. 72
New cmdlets ..................................................................................................................................................................... 72
Issues fixed in Toolkit 1.4 .................................................................................................................................................. 73
Data ONTAP PowerShell Toolkit 1.3 ..................................................................................................................................... 74
SSH invocation .................................................................................................................................................................. 74
Credentials cache .............................................................................................................................................................. 75
FlexShare ........................................................................................................................................................................... 75
PowerShell Provider .......................................................................................................................................................... 76
ShouldProcess ................................................................................................................................................................... 77
ToString ............................................................................................................................................................................. 77
Sorting ............................................................................................................................................................................... 78
Connection enhancements ............................................................................................................................................... 79
Parameter aliases .............................................................................................................................................................. 79
New cmdlets ..................................................................................................................................................................... 79
Issues fixed in Toolkit 1.3 .................................................................................................................................................. 80
Data ONTAP PowerShell Toolkit 1.2 ..................................................................................................................................... 81
Data formatters................................................................................................................................................................. 81
Microsoft Hyper-V integration .......................................................................................................................................... 82
Network configuration ...................................................................................................................................................... 82
New cmdlets ..................................................................................................................................................................... 83
Issues fixed in Toolkit 1.2 .................................................................................................................................................. 83

Data ONTAP PowerShell Toolkit 3.2.1

Full Data ONTAP 8.3 API support
There are as many as 141 cmdlets introduced in Toolkit 3.2.1 and some of which are new categories as well. There are
several updates to existing cmdlets too.

Other enhancements

The following cmdlets have new parameters added:

Add-NcLunMap: Node
New-NcLunMap: ForeignDisk, ThinProvisioningSupportEnabled, Comment
Set-NcAutosupportConfig: MaxUploadRate, MaxDownloadRate, DisableOndemandDownload
New-NcClone: EnableAutodelete, TokenUuid
Enable-NcClone: Force
Set-NcDiskOwner: IsRootPartition, IsDataPartition, CopyOwnerFrom
Clear-NcDiskOwner: IsRootPartition, IsDataPartition
Start-NcSystemImageUpdate: IgnoreOffline
Add-NcFileDirectorySecurityPolicyTask: AccessControl
New-NcFileserviceAudit: AuditEvents
Set-NcFileserviceAudit: AuditEvents
New-NcFpolicyPolicy: IsPassthroughReadEnabled
Set-NcFpolicyPolicy: IsPassthroughReadEnabled
New-NcFpolicyExternalEngine: RecvBufferSize, SendBufferSize, SessionTimeout
Set-NcFpolicyExternalEngine: RecvBufferSize, SendBufferSize, SessionTimeout
Update-NcGpo: ForceReapplyAllSettings
Set-NcPerfPreset: ExpirationLength
Set-NcPerfArchiveConfig: PerfstatSamplingPeriod
Set-NcQosControlConfiguration: PolicyDeactivation
Remove-NcQosPolicyGroup: Force
New-NcQosPolicyReadAhead: MinFileHistogram
Set-NcQosPolicyReadAhead: MinFileHistogram
Set-NcQosPolicyReadAhead: MinFileHistogram
Set-NcQosPolicyReadAhead: MinFileHistogram
New-NcSisPolicy: PolicyType, ChangelogThresholdPercent
Set-NcSisPolicy: PolicyType, ChangelogThresholdPercent
New-NcLdapClient: IsNetgroupByHostEnabled, NetgroupByHostScope, AllowSsl
Set-NcLdapClient: IsNetgroupByHostEnabled, NetgroupByHostScope, AllowSsl, DisallowSsl
Set-NaToolkitConfiguration: LogToFile, NoConsoleOutput
Set-NcldapClientSchema: EnableRfc2307bis, GroupOfUniqueNamesObjectClass, UniqueMemberAttribute,
NisMapEntryAttribute, NisMapNameAttribute, NisObjectClass
Restart-NcNode: AllowInhibitTakeover, Reason, IsDump, AllowLifMigrationBeforeReboot,
IgnoreQuorumWarnings
Stop-NcNode: AllowInhibitTakeover, Reason, IsDump, AllowLifMigrationBeforeShutdown,
IgnoreQuorumWarnings

You can now redirect ZAPI debugging output to a file, optionally with console print. See updates to SetNaToolkitConfiguration above

New cmdlets
PS C:\Users\rathnam\Documents\pstk> get-nccommand -category nameservice
Name
----

Category
--------

Family
------

Api
---

Get-NcNameServiceDNSStatistics
Get-NcNameServiceHostnameFromIP
Get-NcNameServiceIPFromHostname
Get-NcNameServiceNisStatistics
Get-NcNameServiceNsSwitch
New-NcNameServiceNsSwitch
Remove-NcNameServiceNsSwitch
Reset-NcNameServiceDNSStatistics
Reset-NcNameServiceNisStatistics
Set-NcNameServiceNsSwitchSources

nameservice
nameservice
nameservice
nameservice
nameservice
nameservice
nameservice
nameservice
nameservice
nameservice

{cluster,
{cluster}
{cluster}
{cluster,
{cluster,
{vserver}
{vserver}
{cluster,
{cluster,
{vserver}

vserver}

vserver}
vserver}

{name-service-dns-statistics-get-iter}
{nameservice-get-hostname-from-ipv4}
{nameservice-get-ip-from-hostname}
{name-service-nis-statistics-get-iter}
{nameservice-nsswitch-get-iter}
{nameservice-nsswitch-create}
{nameservice-nsswitch-destroy}
{nameservice-dns-statistics-clear}
{nameservice-nis-statistics-clear}
{nameservice-nsswitch-modify}

PS C:\Users\rathnam\Documents\pstk> get-nccommand -category netgroup

Name
---Get-NcNetgroupFile
Remove-NcNetgroupFile

Category
-------netgroup
netgroup

Family
-----{cluster, vserver}
{cluster, vserver}

Api
--{netgroups-file-get-iter}
{netgroups-file-delete}

PS C:\Users\rathnam\Documents\pstk> get-nccommand -category ntp_server

Name
---Get-NcNtpServer
New-NcNtpServer
Remove-NcNtpServer
Reset-NcNtpServer
Set-NcNtpServer
Test-NcNtpServer

Category
-------ntp_server
ntp_server
ntp_server
ntp_server
ntp_server
ntp_server

Family
-----{cluster}
{cluster}
{cluster}
{cluster}
{cluster}
{cluster}

Api
--{ntp-server-get-iter}
{ntp-server-create}
{ntp-server-delete}
{ntp-server-reset}
{ntp-server-modify}
{ntp-server-validate}

PS C:\Users\rathnam\Documents\pstk> get-nccommand -category tape_mc

Name
---Clear-NcTapeMcAlias
Disable-NcTapeMcTrace
Enable-NcTapeMcTrace
Get-NcTapeMc
Reset-NcTapeMc
Set-NcTapeMc
offline}
Set-NcTapeMcAlias
Set-NcTapePosition
Test-NcTapeMc
info-test-release}

Category
-------tape_mc
tape_mc
tape_mc
tape_mc
tape_mc
tape_mc

Family
-----{cluster}
{cluster}
{cluster}
{cluster}
{cluster}
{cluster}

Api
--{tape-mc-info-alias-clear}
{tape-mc-info-trace}
{tape-mc-info-trace}
{tape-mc-get-iter}
{tape-mc-info-reset}
{tape-mc-info-online, tape-mc-info-

tape_mc
tape_mc
tape_mc

{cluster}
{cluster}
{cluster}

{tape-mc-info-alias-set}
{tape-mc-info-position}
{tape-mc-info-test-reserve, tape-mc-

PS C:\Users\rathnam\Documents\pstk> get-nccommand -category *image

Name
---Get-NcClusterImage
Get-NcClusterImageDownload
Get-NcClusterImagePackage
Get-NcClusterImageUpdateHistory
Get-NcClusterImageUpdateLog
Get-NcClusterImageUpdateProgress
iter}
Remove-NcClusterImagePackage
Resume-NcClusterImageUpdate
Start-NcClusterImagePackageDownload
Start-NcClusterImageUpdate
Stop-NcClusterImageUpdate
Suspend-NcClusterImageUpdate
Test-NcClusterImage

Category
-------cluster image
cluster image
cluster image
cluster image
cluster image
cluster image

Family
-----{cluster}
{cluster}
{cluster}
{cluster}
{cluster}
{cluster}

Api
--{cluster-image-get-iter}
{cluster-image-get-download-progress}
{cluster-image-package-local-get-iter}
{cluster-image-update-history-get-iter}
{cluster-image-update-log-get-iter}
{cluster-image-update-progress-get-

cluster
cluster
cluster
cluster
cluster
cluster
cluster

{cluster}
{cluster}
{cluster}
{cluster}
{cluster}
{cluster}
{cluster}

{cluster-image-package-delete}
{cluster-image-update-resume}
{cluster-image-package-download}
{cluster-image-update}
{cluster-image-update-cancel}
{cluster-image-update-resume}
{cluster-image-validate}

image
image
image
image
image
image
image

PS C:\Users\rathnam\Documents\pstk>
Name
---Get-NcLock
Remove-NcLock

get-nccommand -category lock

Category
Family
------------lock
{cluster, vserver}
lock
{cluster, vserver}

Api
--{lock-get-iter}
{lock-break-iter}

PS C:\Users\rathnam\Documents\pstk>
Name
---Invoke-NcCoredump

get-nccommand -category coredump

Category
Family
------------coredump
{cluster}

Api
--{coredump-trigger}

Issues Fixed
Not applicable.

Data ONTAP PowerShell Toolkit 3.2

Data ONTAP 8.3 API support
There are 126 new cmdlets in Toolkit 3.2, many of which are new for Data ONTAP 8.3. Many other cmdlets have been
enhanced with new parameters (see Other enhancements section below for more details).
There are several categories introduced in Data ONTAP 8.3 and Toolkit 3.2 introduces two of them, namely MetroCluster
and Storage Pool.
PS C:\Program Files (x86)\Netapp\Data ONTAP PowerShell Toolkit> get-nccommand -category Metrocluster
Name
---Get-NcMetrocluster
Get-NcMetroclusterAggregateCheck
Get-NcMetroclusterAggregateEligi...
eligibility-get-iter}
Get-NcMetroclusterCheck
Get-NcMetroclusterConfigDiff
Get-NcMetroclusterConfigReplication
Get-NcMetroclusterConfigReplicat...
get}
Get-NcMetroclusterFailedLifPlace...
failures-get-iter}
Get-NcMetroclusterInterconnect
Get-NcMetroclusterInterconnectAd...
iter}
Get-NcMetroclusterInterconnectAd...
switch-get-iter}
Get-NcMetroclusterNode
Get-NcMetroclusterNodeCheck
Get-NcMetroclusterOperation
Get-NcMetroclusterProgress
Get-NcMetroclusterVserver
Invoke-NcMetroclusterCheck
Invoke-NcMetroclusterHeal
Invoke-NcMetroclusterSwitchback
Invoke-NcMetroclusterSwitchover
Register-NcMetrocluster
Repair-NcMetroclusterLifPlacement
placement}
Set-NcMetroclusterConfigReplication
modify}
Sync-NcMetroclusterVserver
Test-NcMetrocluster
Unregister-NcMetrocluster

Category
-------metrocluster
metrocluster
metrocluster

Family
-----{cluster}
{cluster}
{cluster}

Api
--{metrocluster-get}
{metrocluster-check-aggregate-get-iter}
{metrocluster-check-aggregate-

metrocluster
metrocluster
metrocluster
metrocluster

{cluster}
{cluster}
{cluster}
{cluster}

{metrocluster-check-get-iter}
{metrocluster-config-diff-get-iter}
{metrocluster-config-replication-get}
{metrocluster-check-config-replication-

metrocluster

{cluster}

{metrocluster-show-lif-placement-

metrocluster
metrocluster

{cluster}
{cluster}

{metrocluster-interconnect-get-iter}
{metrocluster-interconnect-adapter-get-

metrocluster

{cluster}

{metrocluster-interconnect-adapter-

metrocluster
metrocluster
metrocluster
metrocluster
metrocluster
metrocluster
metrocluster
metrocluster
metrocluster
metrocluster
metrocluster

{cluster}
{cluster}
{cluster}
{cluster}
{cluster}
{cluster}
{cluster}
{cluster}
{cluster}
{cluster}
{cluster}

{metrocluster-node-get-iter}
{metrocluster-check-node-get-iter}
{metrocluster-operation-get-iter}
{metrocluster-progress-table-get-iter}
{metrocluster-vserver-get-iter}
{metrocluster-check-run}
{metrocluster-heal}
{metrocluster-switchback}
{metrocluster-switchover}
{metrocluster-configure}
{metrocluster-check-lif-repair-

metrocluster

{cluster}

{metrocluster-config-replication-

metrocluster
metrocluster
metrocluster

{cluster}
{cluster}
{cluster}

{metrocluster-vserver-resync}
{metrocluster-is-configured}
{metrocluster-unconfigure}

PS C:\Program Files (x86)\Netapp\Data ONTAP PowerShell Toolkit> get-nccommand -category "Storage pool"
Name
---Add-NcStoragePool
Get-NcStoragePool
Get-NcStoragePoolAggr
Get-NcStoragePoolDisk

Category
-------storage pool
storage pool
storage pool
storage pool

Family
-----{cluster}
{cluster}
{cluster}
{cluster}

Api
--{storage-pool-add}
{storage-pool-get-iter}
{storage-pool-aggregate-get-iter}
{storage-pool-disk-get-iter}

Get-NcStoragePoolSpareCapacity
Move-NcStoragePool
New-NcStoragePool
Remove-NcStoragePool

storage
storage
storage
storage

pool
pool
pool
pool

{cluster}
{cluster}
{cluster}
{cluster}

{storage-pool-spare-capacity-get-iter}
{storage-pool-reassign}
{storage-pool-create}
{storage-pool-delete}

Other enhancements
Several cmdlets have been updated to include new parameters. The following cmdlets have new parameters in the
clustered ONTAP cmdlet set:
Add-NcAggr: CacheRaidGroupSize
New-NcAggr: ExcludeFromAutobalance
Set-NcAggr: Force (-Offline option)
Add-NcCifsServer: Comment, NetbiosAlias
Add-NcCifsShare: MaxConnectionsPerShare, ForceGroupForCreate, DisablePathValidation
Add-NcCifsShareAcl: UserGroupType
Remove-NcCifsServer: ForceAccountDelete
Remove-NcCifsServerAcl: UserGroupType
Set-NcCifsOption: IsCopyOffladDirectCopyEnabled, IsUnixNtAclEnabled, ClientSessionTimeout, IsDacEnabled,
AnonymousRestrictionLevel, IsReadOnlyDeleteEnabled, IsFakeOpenEnabled, IsUnixExtensionsEnabled,
IsSearchShortNamesEnabled
Set-NcCifsSecurity: IsAesEncryptionEnabled, LmCompatibilityLevel, AdminCredential
Set-NcCifsServer: Comment, AddNetbiosAlias, RemoveNetbiosAlias
Set-NcCifsShare: MaxConnectionsPerShare, ForceGroupForCreate, IsPathValidationEnabled
Set-NcCifsShareAcl: UserGroupType
Add-NcClusterPeer: AddressFamily, Passphrase, OfferExpiration
Set-NcClusterPeer: AuthStatusAdmin, Passphrase, OfferExpiration
Get-NcNetSanLifPlacement: Subnet, BroadcastDomain, Ipspace
New-NcNetInterface: Subnet, Wwpn, ForceSubnetAssociation
Ping-NcHost: WaitResponse
Set-NcNetInterface: Subet, Wwpn, ForceSubnetAssociation
Set-NcNetPort: Ipspace, MtuAdmin
Invoke-NcSnapmirrorBreak: RestoreDestinationSnapshot
Invoke-NcSnapmirrorCheck: CheckFileListSource, CheckFileListDestination, SourceSnapshot, MaxTransferRate
Invoke-NcSnapmirrorRestore: CreateCheckSnapshot, UseNetworkCompression, RestoreFileList
Invoke-NcSnapmirrorResync: QuickResync
Invoke-NcSnapmirrorUpdate: EnableStorageEfficiency
New-NcVol: CachingPolicy, ExcludedFromAutobalance, Comment
New-NcVolCone: CachingPolicy
New-NcVserver: Ipspace, Subtype
Set-NcVserver: VolumeDeleteRetentionHours
New-NcVserverPeerTransition: LocalLif
Set-NcVserverPeerTransition: LocalLif

New Cmdlets
There are 126 new cmdlets in Toolkit 3.2 making a grand total of 1603 cmdlets!
The following categories in the clustered ONTAP set have new cmdlets:

aggr (16 cmdlets)

cifs (13 cmdlets)
metrocluster (26 cmdlets)
net (48 cmdlets)
o ipspace (4 cmdlets)
o firewall (10 cmdlets)

o failover group (4 cmdlets)

o subnet (5 cmdlets)
o port broadcast domain (7 cmdlets)
o route (4 cmdlets)
o arp (5 cmdlets)
o ndp (9 cmdlets)
storagepool (8 cmdlets)
snapmirror (1 cmdlets)
vserver (7 cmdlets)

Issues Fixed

ConvertTo-NaVmdk could fail when connecting to a vserver management LIF that is also a CIFS data LIF and a
network name was used.
ConvertTo-NaVmdk could fail when connecting to a vserver by name when DNS round robin is used.
Set-NcTime would fail for Data ONTAP 8.2 and higher.
Reset-NcCifsPassword did not have a default parameter set.
Get-NaVol could fail in the vfiler context.

Data ONTAP PowerShell Toolkit 3.1

Perfstat data collection
Perfstat is a tool used to collect performance data from a Data ONTAP controller. The data is collected in a format that
can then be parsed and analyzed by end tools.
Toolkit 3.1 introduces the ability to collect basic Perfstat information with Invoke-NaPerfstat and Invoke-NcPerfstat.
Only FILER data is collectedno HOST or SWITCH commands are run. All data collection is done via SSH, with no
SYSTEMSHELL commands. More advanced Perfstat data collection can be done by the Perfstat tool:
http://support.netapp.com/NOW/download/tools/perfstat/
Both Invoke-NaPerfstat and Invoke-NcPerfstat generate output files that can be several MBs in size. The
OutputDirectory parameter is used to specify which directory to place the output files. A new folder with a unique name
will be generated in the OutputDirectory.
The following command collects perfstat data for the currently connected 7-mode controller:
PS C:\Toolkit\3.1>

Invoke-NaPerfstat -Directory C:\Perfstats -Time 60 -Iterations 2 -IterationSleepTime 30

The parallel commands are run for 60 seconds. Two iterations are performed with 30 seconds between iterations. The
output files are located in the C:\Perfstats directory.
PS C:\Toolkit\3.1>

ls C:\Perfstats

Directory: C:\Perfstats
Mode
---d----

LastWriteTime
------------1/23/2014
3:28 PM

PS C:\Toolkit\3.1>

Length Name
------ ---perfstat_20140123_152829

ls C:\Perfstats\perfstat_20140123_152829

Directory: C:\Perfstats\perfstat_20140123_152829

Mode
---d----

LastWriteTime
------------1/23/2014
3:28 PM

PS C:\Toolkit\3.1>

Length Name
------ ---10.61.167.84

ls C:\Perfstats\perfstat_20140123_152829\10.61.167.84

Directory: C:\Perfstats\perfstat_20140123_152829\10.61.167.84
Mode
----a---a---

LastWriteTime
------------1/23/2014
3:37 PM
1/23/2014
3:37 PM

Length
-----20506925
49575

Name
---output.data
output.index

The following command collects perfstat information for one node in the current cluster. Two iterations are performed
with 10 seconds between iterations.
PS C:\Toolkit\3.1> Invoke-NcPerfstat -Directory C:\Perfstats -Node sfp-cmode-02-01 -Iterations 2 IterationSleepTime 10

The C:\Perfstats directory contains the output.

PS C:\Toolkit\3.1>

ls C:\Perfstats

Directory: C:\Perfstats
Mode
---d----

LastWriteTime
------------1/23/2014
4:02 PM

PS C:\Toolkit\3.1>

Length Name
------ ---perfstat_20140123_160224

ls C:\Perfstats\perfstat_20140123_160224

Directory: C:\Perfstats\perfstat_20140123_160224
Mode
---d----

LastWriteTime
------------1/23/2014
4:02 PM

PS C:\Toolkit\3.1>

Length Name
------ ---10.63.165.54

ls C:\Perfstats\perfstat_20140123_160224\10.63.165.54

Directory: C:\Perfstats\perfstat_20140123_160224\10.63.165.54
Mode
----a---a---

LastWriteTime
------------1/23/2014
4:09 PM
1/23/2014
4:09 PM

Length
-----17539264
28406

Name
---output.data
output.index

Full Data ONTAP 8.2.1 API support

There are 58 new cmdlets in Toolkit 3.1, many of which are new for Data ONTAP 8.2.1. Many other cmdlets have been
enhanced with new parameters (see Other enhancements section below for more details).
There are several completely new categories introduced in Data ONTAP 8.2.1 and Toolkit 3.1.
PS C:\Toolkit\3.1>
Name
---Get-NaUcmAdapter
Set-NaUcmAdapter

Get-NaCommand -Category ucm

Category
-------ucm
ucm

Api
--{ucm-adapter-list-info}
{ucm-adapter-modify}

PS C:\Toolkit\3.1>

Family
-----{cluster, vserver}
{vserver}
{vserver}
{vserver}

active direc... {vserver}

Api
--{active-directory-account-get-iter}
{active-directory-account-create}
{active-directory-account-delete}
{active-directory-account-password{active-directory-account-modify,

Get-NcCommand -Category ucm

Name
---Get-NcUcmAdapter
Set-NcUcmAdapter
PS C:\Toolkit\3.1>

Category
-------active direc...
active direc...
active direc...
active direc...

Category
-------ucm
ucm

Family
-----{cluster}
{cluster}

Api
--{ucm-adapter-get-iter}
{ucm-adapter-modify}

Category
-------vscan
vscan
vscan
vscan
vscan
vscan

Family
-----{vserver}
{vserver}
{vserver}
{vserver}
{cluster, vserver}
{cluster, vserver}

Api
--{vscan-status-modify}
{vscan-on-access-policy-modify}
{vscan-status-modify}
{vscan-on-access-policy-modify}
{vscan-connection-status-all-get-iter}
{vscan-connection-extended-stats-get-

vscan
vscan
vscan
vscan
vscan
vscan
vscan
vscan
vscan
vscan
vscan

{cluster,
{cluster,
{cluster,
{cluster,
{vserver}
{vserver}
{vserver}
{vserver}
{vserver}
{vserver}
{vserver}

{vscan-on-access-policy-get-iter}
{vscan-scanner-pool-get-iter}
{vscan-active-scanner-pool-get-iter}
{vscan-status-get-iter}
{vscan-on-access-policy-create}
{vscan-scanner-pool-create}
{vscan-on-access-policy-delete}
{vscan-scanner-pool-delete}
{vscan-reset}
{vscan-on-access-policy-modify}
{vscan-scanner-pool-modify}

vserver}
vserver}
vserver}
vserver}

Data ONTAP 8.2.1 introduces the ability to export qtrees. A new parameter on New-NcQtree and Set-NcQtree,
ExportPolicy, allows an export policy (created using the cmdlets in the exports category) to be applied to a qtree.
PS C:\Toolkit\3.1>

New-NcExportPolicy -Name qtree_export

PolicyName
---------qtree_export

PolicyId Vserver
-------- ------12884901890 pstk01

PS C:\Toolkit\3.1> New-NcExportRule -Policy qtree_export -ClientMatch 0.0.0.0/0 -ReadOnlySecurityFlavor any ReadWriteSecurityFlavor any
PS C:\Toolkit\3.1>

New-NcQtree -Volume exports -Qtree export1 -ExportPolicy qtree_export

Volume
-----exports

Qtree
----export1

Status
-----normal

SecurityStyle Oplocks
------------- ------unix
enabled

Vserver
------pstk01

Other enhancements
Get-NaHostDisk is used to enumerate disks on the host system. Partner information has been added to the output of
Get-NaHostDisk for 7-mode systems.
PS C:\Toolkit\3.1>
Disk
Size

Get-NaHostDisk 4 | fl *
: 4
: 2198888778240

ControllerPath
ControllerMode
HostDrivePath
HostDiskName
HostVolume
HostVolumeIsCsv
HostGptGuid
HostMbrSignature
HostDiskIndex
DiskSerialNumber
DiskSize
DiskWmiPath
ControllerName
ControllerIgroup
ControllerIgroupType
ControllerAddresses
ControllerLunPath
ControllerVolumeName
ControllerLunOsType
ControllerSnapshot
ControllerQtree
ControllerOntapRevision
ControllerModel
IScsiTarget
FcpTarget
PartnerControllerName
IsHaEnabled
IsHaIcConnected

:
:
:
:
:
:
:
:
:
:
:
:
:
:
:
:
:
:
:
:
:
:
:
:
:
:
:
:

fas2040rre1:/vol/vol1/biggerlun
Classic
E:\
\\?\PhysicalDrive4
\\?\Volume{e09cb9fc-0f93-48b4-acf0-fa3c5bfc12a2}\
False
d7d22034-f5d8-4d3d-a54b-1b41b63b7093
4
P4DahZjB/4vx
2198888778240
\\WIN2K8DEVRRE0\root\cimv2:Win32_DiskDrive.DeviceID="\\\\.\\PHYSICALDRIVE4"
fas2040rre1
win2k8devrre0
Windows
{192.168.0.8, 10.61.169.28}
/vol/vol1/biggerlun
vol1
windows_2008
/vol/vol1
8.0.1 7-Mode
FAS2040
10.61.169.28:3260
fas2040rre2
True
True

Two new cmdlets, Get-NcLunSignature and Set-NcLunSignature, work like their Na- counterparts for clustered ONTAP.
Manipulating LUN signatures is especially useful when cloning LUNs. The following example script shows the usage of
Set-NcLunSignature after cloning a LUN.
function Clone-Disk {
param([int]$DiskIndex)
# Get the Disk to clone
$disk = Get-NaHostDisk -Disk $DiskIndex
# Make sure it's clustered ONTAP
if(-not ($disk.ControllerMode -eq "Cluster")) { Write-Error "Not a clustered ONTAP LUN."; return }
# Connect to the controller (Assuming credentials are in the cache)
$controller = Connect-NcController $disk.ControllerAddresses[0] -Vserver $disk.ControllerName -Transient
if($controller -eq $null) { Write-Error "Could not connect to controller."; return }
# Clone the LUN
$cloneLunPath = $disk.ControllerLunPath + "_$((Get-Date).ToString('yyyyMMdd_hhmmss'))"
$destinationPath = $cloneLunPath.Substring("/vol/$($disk.ControllerVolumeName)".Length)
New-NcClone -Volume $disk.ControllerVolumeName -SourcePath $disk.ControllerLunPath -DestinationPath
$destinationPath -Controller $controller | Out-Null
if(-not $?) { Write-Error "Could not create LUN clone."; return }
# Write a new signature
Set-NcLunSignature -Path $cloneLunPath -Controller $controller

| Out-Null

if(-not $?) { Write-Error "Could not change LUN signature."; return }

# Map the LUN
Add-NcLunMap -Path $cloneLunPath -InitiatorGroup $disk.ControllerIgroup -Controller $controller

| Out-Null

if(-not $?) { Write-Error "Could not map the LUN."; return }

# Wait for the LUN to come online
Start-NaHostDiskRescan
Wait-NaHostDisk -ControllerName $disk.ControllerName -ControllerLunPath $cloneLunPath
}

A Transient switch has been added to Start-NaNdmpCopy to prevent the NDMP copy operation status object being
added to the global variable. The status can then be tracked using the status object emitted by Start-NaNdmpCopy.

Please note: when using the Transient switch, the NDMP copy status will not be returned by Get-NaNdmpCopy. The
status must be captured from Start-NaNdmpCopy.
PS C:\Toolkit\3.1> $ndmp_operation = Start-NaNdmpCopy -SrcController 10.61.167.213 -SrcPath
/beam01/powershell/cifs/VHDX/redhat.vhdx -DstController 10.61.167.86 -DstPath /vol/powershell/redhat SrcCredential root -DstCredential root -SrcAuthType md5 -DstAuthType md5 Transient
PS C:\Toolkit\3.1>

$ndmp_operation

Id
-1

SrcPath
DstPath
BackupBytesProcessed
-------------------------------/beam01/powershell/cifs... /vol/powershell/redhat/
0

State
----RUNNING

PS C:\Toolkit\3.1>

$ndmp_operation.Refresh()

PS C:\Toolkit\3.1>

$ndmp_operation

Id
-1

SrcPath
DstPath
BackupBytesProcessed
-------------------------------/beam01/powershell/cifs... /vol/powershell/redhat/
300 MB

State
----RUNNING

PS C:\Toolkit\3.1>

$ndmp_operation.Refresh()

PS C:\Toolkit\3.1>

$ndmp_operation

Id
-1

SrcPath
DstPath
BackupBytesProcessed
-------------------------------/beam01/powershell/cifs... /vol/powershell/redhat/
827 MB

State
----RUNNING

BackupBytesRemain
----------------0

BackupBytesRemain
----------------25 GB

BackupBytesRemain
----------------24 GB

During an NDMP copy operation, the source and/or destination controllers will send log messages to the host. These log
messages are now captured in the NDMP copy status object.
PS C:\Toolkit\3.1> $ndmp_operation.LogMessages
[10.61.167.213] Log Message: LogType=0, MessageId=1, Message=DUMP: creating
"/beam01/powershell/../snapshot_for_backup.1" snapshot.
[10.61.167.213] Log Message: LogType=0, MessageId=2, Message=DUMP: Using Partial Volume Dump of selected
subtrees
[10.61.167.213] Log Message: LogType=0, MessageId=3, Message=DUMP: Using snapshot_for_backup.1 snapshot
[10.61.167.213] Log Message: LogType=0, MessageId=4, Message=DUMP: Date of this level 0 dump: Wed Jan 22
13:36:43 2014.
[10.61.167.213] Log Message: LogType=0, MessageId=5, Message=DUMP: Date of last level 0 dump: the epoch.
[10.61.167.213] Log Message: LogType=0, MessageId=6, Message=DUMP: Dumping
/beam01/powershell/cifs/VHDX/redhat.vhdx to NDMP connection
[10.61.167.213] Log Message: LogType=0, MessageId=7, Message=DUMP: mapping (Pass I)[regular files]
[10.61.167.213] Log Message: LogType=0, MessageId=8, Message=DUMP: Reading file names from NDMP.
[10.61.167.213] Log Message: LogType=0, MessageId=9, Message=DUMP: mapping (Pass II)[directories]
[10.61.167.213] Log Message: LogType=0, MessageId=10, Message=DUMP: estimated 26269713 KB.
[10.61.167.213] Log Message: LogType=0, MessageId=11, Message=DUMP: dumping (Pass III) [directories]
[10.61.167.213] Log Message: LogType=0, MessageId=12, Message=DUMP: dumping (Pass IV) [regular files]
[10.61.167.86] Log Message: LogType=0, MessageId=1, Message=RESTORE: Wed Jan 22 13:39:42 2014: Begin level 0
restore
[10.61.167.86] Log Message: LogType=0, MessageId=2, Message=RESTORE: Wed Jan 22 13:39:42 2014: Reading
directories from the backup
[10.61.167.86] Log Message: LogType=0, MessageId=3, Message=RESTORE: Wed Jan 22 13:39:43 2014: Creating files
and directories.
[10.61.167.86] Log Message: LogType=0, MessageId=4, Message=RESTORE: Wed Jan 22 13:39:43 2014: Writing data to
files.

Connect-NaController and Connect-NcController will now prompt for credentials when no credentials are supplied and
no credentials are present in the credentials cache.
Set-NaToolkitConfiguration now allows logging to be configured for four different loggers: DataONTAP.PowerShell for
7-mode cmdlet logging, DataONTAP.C.PowerShell for clustered ONTAP cmdlet logging, DataONTAP.HostUtilities for host
utility logging, and NetApp.Ontapi for logging of Data ONTAP API calls. Changing the logging configuration no longer
requires a restart of PowerShell.
PS C:\Toolkit\3.1>

Set-NaToolkitConfiguration DEBUG NetApp.Ontapi

Log
--{DataONTAP.PowerShell: OFF, DataONTAP.C.PowerShell: OFF, DataONTAP.HostUtilities: OFF, NetApp.Ontapi: DEBUG}

If the Logger is not specified, all four loggers will be modified.

PS C:\Toolkit\3.1>

Set-NaToolkitConfiguration DEBUG

Log
--{DataONTAP.PowerShell: DEBUG, DataONTAP.C.PowerShell: DEBUG, DataONTAP.HostUtilities: DEBUG, NetApp.Ontapi:
DEBUG}

Several of the cmdlets in the 7-mode net category modify both the active and persistent configuration. Sometimes
modifying the persistent configuration is not desirable. The 7-mode net cmdlets that modify the persistent
configuration have a new ActiveOnly to indicate only the active configuration should be modified. The following cmdlets
contain the new switch: Add-NaNetRoute, Add-NaNetVlan, New-NaNetVif, Remove-NaNetRoute, Remove-NaNetVif,
Remove-NaNetVlan, Set-NaNetInterface, Set-NaNetVif, Set-NaNetVlan
The following example shows how the ActiveOnly switch can remove Vlans from the active configuration and keep them
in the persistent configuration:
PS C:\Toolkit\3.1>
PS C:\Toolkit\3.1>
ConfigStatus
Ifgrps
Interfaces
Routes
Vlans

:
:
:
:
:

{}
{}
{e0a, e0b, e0c, e0d...}
{default}
{}

PS C:\Toolkit\3.1>
ConfigStatus
Ifgrps
Interfaces
Routes
Vlans

:
:
:
:
:

Remove-NaNetVlan -Interface e0c -Vlans 40, 50 -ActiveOnly

Get-NaNetActiveConfig

Get-NaNetPersistentConfig

{}
{}
{e0a, e0b, e0c, e0d...}
{default}
{e0c-40, e0c-50}

Several cmdlets have been updated to include new parameters. The following cmdlets have new parameters in the 7mode cmdlet set:
Add-NaNetRoute: ActiveOnly
Add-NaNetVlan: ActiveOnly
New-NaNetVif: ActiveOnly
Remove-NaNetRoute: ActiveOnly
Remove-NaNetVif: ActiveOnly
Remove-NaNetVlan: ActiveOnly
Restore-NaSnapshotFile: SpaceEfficientSplitDisabled, Force

Restore-NaSnapshotVolume: Uuid, Force

Set-NaNetInterface: ActiveOnly
Set-NaNetVif: ActiveOnly
Set-NaNetVlan: ActiveOnly
Start-NaNdmpCopy: Transient
The following cmdlets have new parameters in the clustered ONTAP cmdlet set:
Add-NcCifsShare: VscanProfile
Get-NcQosWorkload: PolicyGroup
Invoke-NcSnapmirrorInitialize: SourceSnapshot
New-NcFileserviceAudit: Format
New-NcLdapClient: UseStartTls
New-NcQtree: ExportPolicy
Restore-NcSnapshotFile: Force
Restore-NcSnapshotVolume: Force
Set-NcCifsOption: IsTrustedDomainEnumSearchEnabled, FileSystemSectorSize
Set-NcCifsSecurity: UseStartTlsForAdLdap
Set-NcCifsShare: VscanProfile
Set-NcFileserviceAudit: Format
Set-NcLdapClient: UseStartTls
Set-NcQtree: ExportPolicy

New Cmdlets
There are 58 new cmdlets in Toolkit 3.1, for a grand total of 1437 cmdlets!
The following categories in the 7-Mode set have new cmdlets:

cf (2 cmdlets)
toolkit (1 cmdlet)
ucm (2 cmdlets)

The following categories in the clustered ONTAP set have new cmdlets:

active directory (5 cmdlets)

cf (6 cmdlets)
cifs (6 cmdlets)
file( 1 cmdlet)
fileservice audit (1 cmdlet)
lun (4 cmdlets)
net (6 cmdlets)
perf (1 cmdlet)
security (2 cmdlets)
snapshot (1 cmdlet)
toolkit (1 cmdlet)
ucm (2 cmdlets)
vscan (17 cmdlets)

Issues Fixed

Compliance clock info XML parsing for Data ONTAP 8.2.

Rename-NaQtree did not work when the qtree contained spaces in the name.

Set-NaTime with DateTime set UTC time erroneously.

WriteBytesPerSecond value incorrect for LUN stats in Invoke-NcSysstat.

Data ONTAP PowerShell Toolkit 3.0

Sysstat for clustered Data ONTAP
Toolkit 3.0 introduces Invoke-NcSysstat, a cmdlet designed to report live performance data of the cluster. Like InvokeNaSysstat, Invoke-NcSysstat monitors several performance counters to report on components of the system. The
following performance statistics can be retrieved: System, FCP, NFSv3, NFSv4, CIFS, iSCSI, Volume, Ifnet, LUN, and Disk.
To use Invoke-NcSysstat, simply provide a switch indicating which type of performance statistics to retrieve. Use the
Name parameter to monitor only specific performance objects. For example, to monitor volumes named powershell
in the cluster:
PS C:\Toolkit\3.0> Invoke-NcSysstat -Volume -Name powershell -Count 5
Name
---powershell
powershell
powershell
powershell
powershell

RdOps
----0
0
0
1
0

WrOps TotOps
----- -----430
434
515
519
622
631
600
604
590
599

RdLat
----0.0
13.3
0.1
4.6
0.1

WrLat
----0.5
0.7
0.8
1.0
0.9

TotLat
-----0.6
0.8
0.9
1.0
1.0

Read Written
---- ------1 KB
27 MB
1 KB
32 MB
2 KB
39 MB
2 KB
37 MB
2 KB
37 MB

The Name parameter also accepts wildcards:

PS C:\Toolkit\3.0> Invoke-NcSysstat -Lun Name /vol/powershell/*
Read
---0
135 B
0

Written
------0
0
128 B

RdOps
----0
0
0

WrOps TotOps
----- -----0
0
0
1
128
128

TotLat
-----0.0
2.0
217.0

LunPath
------/vol/powershell/disk1_gpt
/vol/powershell/luns/cluster
/vol/powershell/luns/disk0

Invoke-NcSysstat works in both the cluster and Vserver context for Data ONTAP 8.2 and up. For Data ONTAP versions
previous to 8.2, Invoke-NcSysstat must be run in the cluster context. The following performance statistics can be
retrieved in the Vserver context: FCP, NFSv3, NFSv4, CIFS, iSCSI, Volume, and LUN.
When run in the cluster context, select monitored performance objects can be filtered by node or Vserver. InvokeNcSysstat will then only monitor the performance objects associated with the given node or Vserver. For example, to
monitor all of the volumes on a specific Vserver:
PS C:\Toolkit\3.0> Invoke-NcSysstat -Volume -Vserver beam01
Name
---beam01_root_vol
clusterdisks
davidCModeIscsiMoun1
ndmp_destination
powershell
testvol
v1NfsSrCMode
vmstorage

RdOps
----0
0
0
0
0
0
0
0

WrOps TotOps
----- -----0
0
0
0
0
0
0
0
370
370
0
0
0
0
0
0

RdLat
----0.0
0.0
0.0
0.0
0.0
0.0
0.0
0.0

WrLat
----0.0
0.0
0.0
0.0
0.2
0.0
0.0
0.0

TotLat
-----0.0
0.0
0.0
0.0
0.2
0.0
0.0
0.0

Read Written
---- ------0
0
0
0
0
0
0
0
0
23 MB
0
0
0
0
0
0

The following example demonstrates how to monitor specific network ports on the node MFIT-01:
PS C:\Toolkit\3.0> Invoke-NcSysstat -Ifnet -Name e0* -Node MFIT-01

Rcv
--833 B
0
2 KB
0

RcvPkt RcvMPkt RcvDrop

------ ------- ------12
12
0
0
0
0
23
12
0
0
0
0

RcvErr
-----0
0
0
0

Snd
--900 B
0
2 KB
0

SndPkt SndMPkt
------ ------1
0
0
0
12
0
0
0

SndErr
-----0
0
0
0

Coll
---0
0
0
0

Ifnet
----MFIT-01:kernel:e0M
MFIT-01:kernel:e0P
MFIT-01:kernel:e0a
MFIT-01:kernel:e0b

The following performance statistics can be filtered by Vserver: FCP, Volume, CIFS, iSCSI. The following performance
statistics can be filtered by node: FCP, Ifnet, Disk, Volume, CIFS, iSCSI, System.
Additionally, Invoke-NcSysstat can aggregate the performance statistics for select objects by Vserver or node. Instead
of displaying the performance results for each individual object, the performance statistics are aggregated for all the
objects on the given Vserver or node. The following example aggregates the volume performance for all of the volumes
in Vserver beam01:
PS C:\Toolkit\3.0> Invoke-NcSysstat -Volume -Vserver beam01 -Aggregated -Count 5
Name
---beam01
beam01
beam01
beam01
beam01

RdOps
----0
0
0
1
0

WrOps TotOps
----- -----257
266
606
614
357
363
22
24
1
8

RdLat
----0.0
0.0
0.0
0.0
0.0

WrLat
----0.2
0.2
0.3
0.2
0.1

TotLat
-----0.2
0.3
0.3
2.6
0.1

Read Written
---- ------0
16 MB
0
38 MB
0
22 MB
341 B
1 MB
0
2 KB

The following example aggregates the CIFS performance for all of the CIFS servers on the node MFIT-01:
PS C:\Toolkit\3.0> Invoke-NcSysstat -Cifs -Node MFIT-01 -Aggregated -Count 5
Name
---MFIT-01
MFIT-01
MFIT-01
MFIT-01
MFIT-01

RdOps
----0
0
0
0
0

WrOps TotOps
----- -----152
155
153
156
121
123
154
158
155
157

RdLat
----0.0
0.0
0.0
0.0
0.0

WrLat
----0.3
0.3
0.3
0.3
0.3

TotLat
-----0.3
0.3
0.3
0.3
0.3

The CIFS, iSCSI, FCP, and Volume performance statistics can be aggregated by node or Vserver.

Full Data ONTAP 8.2 API support

Toolkit 3.0 completes the API support for Data ONTAP 8.2.
In addition to the 67 new cmdlets added for Toolkit 3.0, there are several cmdlets that have been updated with new
parameters.
The following parameters have been added to the 7-mode cmdlet set:

ConvertTo-NaVhd: FollowParent
ConvertTo-NaVhdx: FollowParent
Read-NaDirectory: Encode
Set-NaDiskOwner: All, DiskCount, DiskType
Start-NaClone: IgnoreStreams, IgnoreLocks

The following parameters have been added to the clustered ONTAP cmdlet set:

Add-NcSnmpCommunity: VserverContext
Copy-NcLdapClientSchema: VserverContext
Get-NcNfsService: Query

Get-NcPerfInstance: VserverContext
Invoke-NcClusterHaTakeover: BypassOptimization, SkipLifMigration
New-NcClone: IgnoreStreams, IgnoreLocks, QosPolicyGroup
New-NcFlexcachePolicy: MetafilesTimeToLive, SymbolicTimeToLive, OtherTimeToLive, DelegationLruTimeout,
PreferLocalCache, Vserver
New-NcLdapClient: VserverContext
New-NcUser: Comment
Read-NcFile: Stream
Remove-NcFlexcachePolicy: Vserver
Remove-NcLdapClient: VserverContext
Remove-NcLdapClientSchema: VserverContext
Remove-NcSnmpCommunity: VserverContext
Set-NcAutoSupportConfig: IsOndemandEnabled, IsOndemandRemoteDiagEnabled, OndemandServerUrl,
OndemandPollingInterval, MinimumPrivateDataLength
Set-NcDiskOwner: All, DiskCount, DiskType
Set-NcFlexcachePolicy: MetafilesTimeToLive, SymbolicTimeToLive, OtherTimeToLive, DelegationLruTimeout,
PreferLocalCache, Vserver
Set-NcLdapClient: VserverContext
Set-NcLdapClientSchema: VserverContext
Set-NcRoleConfig: MinPasswordSpecialCharacter, PasswordExpirationDuration, MaxFailedLoginAttempts,
LockoutDurationDays, RequireInitialPasswordUpdate
Set-NcUser: Comment
Write-NcFile: Stream

Other Enhancements
Get-NaVirtualDiskAlignment and Repair-NaVirtualDiskAlignment are able to detect and repair alignment issues with
VHD format virtual disks. Toolkit 3.0 extends the functionality of these two cmdlets to include VHDX format virtual
disks.
PS C:\Toolkit\3.0> Get-NaVirtualDiskAlignment C:\ClusterStorage\Volume2\VirtualDisks\Win2k3_VM1\win2k3-boot.vhdx
VirtualDisk: C:\ClusterStorage\Volume2\VirtualDisks\Win2k3_VM1\win2k3-boot.vhdx
IsBootable
---------True

AbsoluteStartingLba
------------------63

Size
---20 GB

IsExtendedBootRecord
-------------------False

IsAligned
--------False

PS C:\Toolkit\3.0> Repair-NaVirtualDiskAlignment C:\ClusterStorage\Volume2\VirtualDisks\Win2k3_VM1\win2k3boot.vhdx

Using host-based copy
A host-based copy will be used. This may take several minutes.
[Y] Yes [N] No [S] Suspend [?] Help (default is "Y"):
Mode
----a---

Are you sure you wish to continue?

LastWriteTime
Length Name
------------------ ---7/11/2013
4:21 PM 21479030784 win2k3-boot.vhdx

Set-NaVirtualDiskSize enables the growing and shrinking of VHD format virtual disks. Shrinking a disk immediately
reclaims the free space and growing a disk does not consume any additional space until data is written to the disk.
Toolkit 3.0 extends the functionality of Set-NaVirtualDiskSize to include growing and shrinking VHDX format virtual
disks. Please note: shrinking dynamic VHDX format virtual disks is not supported.
PS C:\Toolkit\3.0> Set-NaVirtualDiskSize C:\ClusterStorage\Volume2\VirtualDisks\Win2k3_VM1\win2k3-boot.vhdx
+10GB
Grow VHD

Are you sure you want to grow the VHD?

[Y] Yes [A] Yes to All [N] No [L] No to All
Mode
----a---

[S] Suspend

[?] Help (default is "Y"):

LastWriteTime
Length Name
------------------ ---7/12/2013 11:58 AM 32216449024 win2k3-boot.vhdx

The NDMP copy cmdlets (Start-NaNdmpCopy and Invoke-NaNdmpCopy) use the credentials cache to look up
credentials to use to authenticate the NDMP session when no credentials are given in the cmdlet parameters. Before
Toolkit 3.0, the credentials would only be looked up based on the IP addresses supplied in the cmdlet parameters. If the
credentials are stored by hostname, the cmdlet would not find them and the NDMP session would not successfully
authenticate. With Toolkit 3.0, the NDMP copy cmdlets will look up the credentials based on the IP addresses given and
the hostnames associated with the IP addresses.
Prior to Toolkit 3.0, both SrcController and DstController were required parameters on Start-NaNdmpCopy and InvokeNaNdmpCopy. In Toolkit 3.0, DstController is no longer required. If the DstController parameter is omitted, the cmdlet
uses the SrcController as the destination.
PS C:\Toolkit\3.0> Invoke-NaNdmpCopy -SrcController 10.61.169.29 -SrcPath /vol/vol2/cifs/dynamic.vhdx -DstPath
/vol/powershell/vol2dst -SrcAuthType md5 -DstAuthType md5

Copy-NaHostFile has been enhanced to offload copying to Data ONTAP when cloning cannot be used. This behavior is
enabled for files in CIFS shares in Data ONTAP 7.3.5 and higher (excluding Data ONTAP 8.0), and for files in a LUN in Data
ONTAP 8.1.1 and higher. Currently, only 7-Mode is supported.
The below table shows the performance increase for using Copy-NaHostFile to offload the copy operation of a 5GB data
file to Data ONTAP when cloning is not possible:
CIFS

LUN

Copy-NaHostFile

29.744 seconds

37.454 seconds

Copy-Item

2 minutes 45 seconds

1 minute 48 seconds

Copy-NaHostFile has also been enhanced to accept a directory in the DestinationFile parameter. The destination file will
be placed in the given directory with the same name as the source file.
Show-NaHelp now displays help for aliased cmdlets in the clustered ONTAP online help documentation.

New Cmdlets
There are 67 new cmdlets included in Toolkit 3.0, for a total of 1379 cmdlets!
The following clustered ONTAP categories contain new cmdlets:

autosupport (1 cmdlets)
cf (2 cmdlets)
clone (2 cmdlets)
diagnosis (1 cmdlets)
file directory security (21 cmdlets)
fileservice audit (6 cmdlets)
ndmp (1 cmdlets)

perf (8 cmdlets)
sectrace (6 cmdlets)
security certificate (8 cmdlets)
security ssl (2 cmdlets)
service processor (9 cmdlets)

Issues Fixed

Timestamp output sometimes not returned correctly for Get-NcPerfData.

Get-NaSnapmirrorConnection address pairs were missing for Data ONTAP 8.2.
Controller connection serialized then deserialized with ConvertTo-SerializedString and ConvertFromSerializedString would not initialize ONTAPI version properly.
Several of the "Related Links" in the online help documentation were broken.
NDMP copy cmdlets (Invoke-NaNdmpCopy and Start-NaNdmpCopy) could hang if the source path does not
exist.
Performance of SCSI unmap (used for New-NaVirtualDisk, Remove-NaHostFile, InvokeNaHostVolumeSpaceReclaim, etc) has been improved.
Divide-by-zero error could occur in Get-NcEfficiency.

Data ONTAP PowerShell Toolkit 2.4

Virtual Disk Space Reclamation
When running virtual machines in a thin environment, the space savings of thin provisioning will decline over time. As
files are added and removed from the virtual machine, the storage controller hosting the virtual disk may not be aware
of the newly-freed blocks. These blocks will remain used while the virtual machine is running. This behavior results in
long-running virtual machines consuming nearly all of the space allocated even when the virtual machine is not full.
Toolkit 2.4 introduces a new cmdlet, Invoke-NaVirtualDiskSpaceReclaim, which enables the space reclamation of virtual
disks (VHD and VHDX format, NTFS file system). With Windows Server 2012, it is possible to perform space reclamation
on a running virtual machine by taking a Hyper-V snapshot of the running virtual machine, running InvokeNaVirtualDiskSpaceReclaim, and then removing the Hyper-V snapshot.
Consider the following example which reclaims space on a Windows Server 2008R2 virtual machine:
PS C:\Toolkit\2.4> Get-NcLun /vol/clusterdisks/disk1 | select Path, SizeUsed
Path
---/vol/clusterdisks/disk1
PS C:\Toolkit\2.4> Measure-Command -Expression {
>> Checkpoint-VM -Name Win2K8R2_VM1 -SnapshotName base
>> Invoke-NaVirtualDiskSpaceReclaim -Name C:\ClusterStorage\Volume2\VirtualDisks\win2k8r2_vm1.vhdx Confirm:$false
>> Remove-VMSnapshot -Name base -VMName Win2K8R2_VM1
>> }
>>
Days
Hours
Minutes
Seconds
Milliseconds
Ticks
TotalDays
TotalHours
TotalMinutes
TotalSeconds

:
:
:
:
:
:
:
:
:
:

0
0
0
23
974
239748180
0.000277486319444444
0.00665967166666667
0.3995803
23.974818

SizeUsed
-------83905994752

TotalMilliseconds : 23974.818

PS C:\Toolkit\2.4> Get-NcLun /vol/clusterdisks/disk1 | select Path, SizeUsed

Path
---/vol/clusterdisks/disk1

SizeUsed
-------78674378752

PS C:\Toolkit\2.4> (83905994752-78674378752)/1gb
4.87232208251953

We reclaimed just under 5GB of space in 24 secondsall without having to take the VM offline!

VMDK to VHD/VHDX with IDE driver injection for Windows Server 2003
If you have ever tried to convert a SCSI VMDK containing Windows Server 2003 to VHD or VHDX, you are probably all too
familiar with the STOP: 0x0000007b error. This occurs when booting the resulting VHD or VHDX after the
conversionrequiring a system repair to remedy.
Toolkit 2.4 introduces the Win2K3ScsiToIde switch to ConvertTo-NaVhd and ConvertTo-NaVhdx. When this switch is
present, the Toolkit will automatically install and configure the IDE drivers in a Windows Server 2003 virtual disk. This
will allow the virtual disk to boot successfully in Hyper-V after the conversion.
PS C:\Toolkit\2.4> ConvertTo-NaVhdx -SourceVmdk C:\ClusterStorage\Volume2\VirtualDisks\VMDK\disk1
.vmdk -DestinationVhdx C:\ClusterStorage\Volume2\VirtualDisks\VMDK\disk1.vhdx -Win2k3ScsiToIde
Mode
----a---

LastWriteTime
Length Name
------------------ ---4/23/2013 10:27 AM 21479030784 disk1.vhdx

Data ONTAP 8.2 API Support

Data ONTAP 8.2 includes a plethora of new and updated APIs. The Data ONTAP PowerShell Toolkit 2.4 includes API
coverage for many of the new APIs.
The Data ONTAP licensing system has been updated for Data ONTAP 8.2. For clustered ONTAP, the new cmdlets in the
license category enable the management of licenses:
PS C:\Toolkit\2.4> Get-NcCommand -Category license
Name
---Add-NcLicense
Get-NcLicense
Remove-NcLicense
unuse...

Category
-------license
license
license

Family
-----{cluster}
{cluster}
{cluster}

Api
--{license-v2-add}
{license-v2-list-info}
{license-v2-delete, license-v2-delete-

For 7-Mode, the existing license cmdlets have been updated to work with the new licensing APIs. The output for GetNaLicense looks slightly different for Data ONTAP 8.2:
PS C:\Toolkit\2.4> Get-NaLicense -Controller $DOT_8_2
Service
------CIFS
FlexClone
iSCSI
NFS
SnapMirror
SnapRestore
SnapVault

Licensed
-------True
True
True
True
True
True
True

Owner
----stl2240-2-1
stl2240-2-1
stl2240-2-1
stl2240-2-1
stl2240-2-1
stl2240-2-1
stl2240-2-1

Expiration
----------

Notice all of the features listed are licensed. In order to see the status of all of the features, including those that are
currently not licensed, use the new Get-NaFeatureStatus cmdlet:

PS C:\Toolkit\2.4> Get-NaFeatureStatus -Controller $DOT_8_2

FeatureName
----------CDMI
CIFS
Compression
Dedupe
FCP
FlexCache
FlexClone
iSCSI
Multistore
NDMP
NFS
snapdrive_unix
snapdrive_windows
SnapLock
Snaplock_Enterprise
snapmanager_exchange
snapmanager_hyperv
snapmanager_oracle
snapmanager_sap
snapmanager_sharepoint
snapmanager_sql
Snapmirror
Snaprestore
Snapvault_Primary
Snapvault_Secondary
Syncmirror

Notes
----Feature
Feature
Feature
Feature
Feature
Feature
Feature
Feature
Feature
Feature
Feature
Feature
-

not licensed

not
not
not
not
not
not
not
not
not
not

licensed
licensed
licensed
licensed
licensed
licensed
licensed
licensed
licensed
licensed

Status
-----not_available
available
on
on
not_available
off
available
on
on
on
available
not_available
not_available
not_available
not_available
not_available
not_available
not_available
not_available
not_available
not_available
on
available
on
on
on

In addition to the new cmdlets (see the New Cmdlets section below for more information on all the new cmdlets in
Toolkit 2.4), many cmdlets have been updated to support Data ONTAP 8.2. In all, over 60 cmdlets have been updated
for Toolkit 2.4!
The following parameters have been added to the 7-Mode cmdlet set:

Set-NaAggr: Force
New-NaAggr: SparePool, AllowMixedRpm, IgnorePoolChecks, PreCheck
Add-NaAggr: AllowMixedRpm, IgnorePoolChecks, PreCheck, ForceCacheSize, CacheRaidType
New-NaAggrMirror: AllowMixedRpm, IgnorePoolChecks, PreCheck
Set-NaSis: EnableIdd, QuickCheckFileSize
Start-NaSis: ScanAll, BuildMetadata, QosPolicy
Set-NaSnapmirrorSchedule: IsCompressed, TcpWindowSize
Set-NaSnapmirrorSyncSchedule: IsCompressed, TcpWindowSize
Set-NaVolAutosize: MinimumSize, GrowThresholdPercent, ShrinkThresholdPercent, Reset, EnableGrow,
EnableGrowShrink
New-NaVolClone: VolumeType

The following parameters have been added to the clustered ONTAP cmdlet set:

New-NcAggr: AllowMixedRpm, IgnorePoolChecks, PreCheck

Add-NcAggr: AllowMixedRpm, IgnorePoolChecks, PreCheck, ForceCacheSize, CacheRaidType
Set-NcAggr: Plex, Force
Remove-NcAggr: Plex
Set-NcCifsOption: ShadowcopyDirDepth, IsSmb3Enabled, IsCopyOffloadEnabled, DefaultUnixGroup,
IsShadowCopyEnabled, IsReferralEnabled, IsLocalAuthEnabled, IsLocalUsersAndGroupsEnabled,
IsUseJunctionsAsReparsePointsEnabled, IsExportPolicyEnabled
Set-NcCifsSecurity: IsSigningRequired, IsPasswordComplexityRequired
Set-NcCifsServer: AdministrativeStatus, Domain, AdminUsername, AdminPassword, AdminCredential,
ForceAccountOverwrite
Add-NcCifsServer: AdministrativeStatus

Set-NcCifsShare: OfflineFilesMode
Add-NcCifsShare: OfflineFilesMode
Ping-NcHost: UseSourcePort
Remove-NcLun: DestroyFencedLun
New-NcLun: QosPolicyGroup, Class
New-NcNetInterface: NetmaskLength, ListenForDnsQuery
Set-NcNetInterface: NetmaskLength, ListenForDnsQuery
Set-NcQosPolicyReadAhead: Name, UseHistogram
Set-NcQosWorkload: Name, ReadAhead
Remove-NcQosWorkload: Name
Enable-NcSis: InfiniteVolume
Set-NcSis: InfiniteVolume, EnableIdd, QuickCheckFileSize
Start-NcSis: InfiniteVolume, ScanAll, BuildMetadata, QosPolicy
Stop-NcSis: InfiniteVolume
Disable-NcSis: InfiniteVolume
Set-NcSisPolicy: QosPolicy
New-NcSisPolicy: QosPolicy
Update-NcSnapmirror: Policy
Remove-NcSnapmirror: InfiniteVolume
Get-NcSnapmirror: VserverContext
New-NcSnapmirror: Policy
Set-NcSnapmirror: Policy
Invoke-NcSnapmirrorAbort: InfiniteVolume
Invoke-NcSnapmirrorBreak: InfiniteVolume
Invoke-NcSnapmirrorInitialize: TransferPriority
Invoke-NcSnapmirrorQuiesce: Query, ContinueOnFailure, MaxFailureCount
Invoke-NcSnapmirrorResume: Query, ContinueOnFailure, MaxFailureCount
Invoke-NcSnapmirrorResync: SourceSnapshot, Preserve
Invoke-NcSnapmirrorUpdate: SourceSnapshot, TransferPriority
Remove-NcSnapshot: InfiniteVolume
New-NcSnapshot: SnapmirrorLabel, InfiniteVolume
New-NcSnapshotPolicy: SnapmirrorLabel
Add-NcSnapshotPolicySchedule: SnapmirrorLabel
Set-NcSnapshotPolicySchedule: SnapmirrorLabel
Restore-NcSnapshotVolume: InfiniteVolume
Update-NcVol: InfiniteVolume
Set-NcVol: InfiniteVolume
New-NcVol: QosPolicyGroup, ConstituentRole, StorageService, InfiniteVolume, NamespaceAggregate,
MaxNamespaceConstituentSize, MaxDataConstituentSize, NamespaceMirrorAggregate, DataAggregate,
EnableSnapdiff, Language
Rename-NcVol: InfiniteVolume
Remove-NcVol: InfiniteVolume
Set-NcVolAutosize: Reset, Mode, MinimumSize, GrowThresholdPercent, ShrinkThresholdPercent
New-NcVolClone: VolumeType, QosPolicyGroup
Get-NcVolLimit: NamespaceAggregate, MaxNamespaceConstituentSize, MaxDataConstituentSize,
DataAggregate, EnableSnapdiff, NamespaceMirrorAggregate
Set-NcVolSize: InfiniteVolume
Set-NcVserver: QosPolicyGroup, Language

Other Enhancements
Many of the host-side cmdlets use the Na prefix even when they are able to operate on either a 7-Mode or clustered
ONTAP controller. In order to prevent confusion, all of these cmdlets have been aliased with the Nc prefix.
PS C:\Toolkit\2.4> Get-Alias | where { $_.ModuleName -eq 'DataONTAP' }
Capability
---------Cmdlet
Cmdlet
Cmdlet
Cmdlet
Cmdlet
Cmdlet
Cmdlet
Cmdlet
Cmdlet
Cmdlet
Cmdlet
Cmdlet
Cmdlet
Cmdlet
Cmdlet
Cmdlet
Cmdlet
Cmdlet
Cmdlet
Cmdlet
Cmdlet
Cmdlet
Cmdlet
Cmdlet
Cmdlet
Cmdlet
Cmdlet
Cmdlet
Cmdlet
Cmdlet
Cmdlet
Cmdlet
Cmdlet
Cmdlet
Cmdlet
Cmdlet
Cmdlet
Cmdlet
Cmdlet
Cmdlet
Cmdlet

Name
---Add-NcHostIscsiConnection
Connect-NcHostIscsiTarget
ConvertTo-NcLun
ConvertTo-NcVhd
ConvertTo-NcVhdx
ConvertTo-NcVmdk
Copy-NcHostFile
Disconnect-NcHostIscsiTarget
Dismount-NcHostVolume
Dismount-NcVirtualDisk
Format-NcHostVolume
Get-NcHostDisk
Get-NcHostFcAdapter
Get-NcHostFcConnectivity
Get-NcHostIscsiAdapter
Get-NcHostIscsiSession
Get-NcHostIscsiTarget
Get-NcHostVolume
Get-NcHyperV
Get-NcVirtualDiskAlignment
Get-NcVssProvider
Get-NcVssSnapshot
Get-NcVssWriter
Initialize-NcHostDisk
Invoke-NcHostVolumeSpaceReclaim
Invoke-NcVirtualDiskSpaceReclaim
Invoke-NcVssBackup
Mount-NcHostVolume
Mount-NcVirtualDisk
New-NcHostVolume
New-NcVirtualDisk
Remove-NcHostFile
Remove-NcHostIscsiConnection
Remove-NcHostVolume
Repair-NcVirtualDiskAlignment
Restore-NcHostFile
Set-NcHostDisk
Set-NcHostVolumeSize
Set-NcVirtualDiskSize
Start-NcHostDiskRescan
Wait-NcHostDisk

ModuleName
---------DataONTAP
DataONTAP
DataONTAP
DataONTAP
DataONTAP
DataONTAP
DataONTAP
DataONTAP
DataONTAP
DataONTAP
DataONTAP
DataONTAP
DataONTAP
DataONTAP
DataONTAP
DataONTAP
DataONTAP
DataONTAP
DataONTAP
DataONTAP
DataONTAP
DataONTAP
DataONTAP
DataONTAP
DataONTAP
DataONTAP
DataONTAP
DataONTAP
DataONTAP
DataONTAP
DataONTAP
DataONTAP
DataONTAP
DataONTAP
DataONTAP
DataONTAP
DataONTAP
DataONTAP
DataONTAP
DataONTAP
DataONTAP

Toolkit 2.4 supports the Update-Help cmdlet in PowerShell 3.0. Since the Toolkit module is a PowerShell 2.0 module,
the HelpInfoURI property is not present by default. In order to use Update-Help, you must first add the HelpInfoURI
property to the Toolkit module using Add-NaHelpInfoUri. Update-Help will be available the next time the Toolkit
module is loaded.
PS C:\Toolkit\2.4> Get-Module DataONTAP | select HelpInfoUri
HelpInfoUri
-----------

PS C:\Toolkit\2.4> Add-NaHelpInfoUri
WARNING: HelpInfoURI will be available the next time the DataONTAP module is loaded.
PS C:\Toolkit\2.4> Remove-Module DataONTAP
PS C:\Toolkit\2.4> Import-Module DataONTAP
PS C:\Toolkit\2.4> Get-Module DataONTAP | select HelpInfoUri
HelpInfoUri
----------http://powershell.netapp.com/help/DataONTAP/

New Cmdlets
The following are new cmdlets, not including the Data ONTAP 8.2 API set:

Invoke-NaVirtualDiskSpaceReclaim

The following 7-Mode categories contain new cmdlets:

aggr (1 cmdlet)
feature (1 cmdlet)
volume (2 cmdlets)

The following clustered ONTAP categories contain new cmdlets:

aggr (8 cmdlets)
cifs (31 cmdlets)
cluster (2 cmdlets)
feature (1 cmdlet)
fpolicy (22 cmdlets)
group mapping (5 cmdlets)
license (3 cmdlets)
lun (3 cmdlets)
net (6 cmdlets)
qos (10 cmdlets)
qtree (1 cmdlet)
snapmirror (7 cmdlets)
snapmirror policy (7 cmdlets)
snapshot (4 cmdlets)
system (1 cmdlet)
volume (5 cmdlets)
vserver (1 cmdlet)
vserver peer (7 cmdlets)
vserver peer transition (4 cmdlets)

Issues Fixed

Get-NaCommand and Get-NcCommand were case-sensitive.

Get-NaCifsShare would not fill out IsAccessBasedEnum value.
Invoke-NaHostVolumeSpaceReclaim would emit "Target volume is not hosted by Data ONTAP" error on
Windows Server 2003.

Data ONTAP PowerShell Toolkit 2.3

VSS Requester
The Microsoft Volume Shadow Copy Service (VSS) enables administrators to create consistent backups of volumes
without degrading performance of running applications or services. This requires cooperation between the backup
application (VSS requester), the host applications (VSS writers), and the storage system (VSS provider). Toolkit 2.3
provides basic VSS requester functionality which enables the creation of volume level shadow copies. It is
recommended to have the Data ONTAP VSS Hardware Provider installed. This is available with SnapDrive for Windows.

Toolkit 2.3 introduces four new cmdlets used to interact with VSS: Get-NaVssProvider, Get-NaVssSnapshot, GetNaVssWriter, and Invoke-NaVssBackup.
Get-NaVssProvider retrieves information about the VSS providers on the host system.
PS C:\Toolkit\2.3.0> Get-NaVssProvider
ProviderId
ProviderName
ProviderType
ProviderVersion
ProviderVersionId
ClassId

:
:
:
:
:
:

b5946137-7b9f-4925-af80-51abd60b20d5
Microsoft Software Shadow Copy provider 1.0
SYSTEM
1.0.0.7
00000001-0000-0000-0007-000000000001
65ee1dba-8ff4-4a58-ac1c-3470ee2f376a

ProviderId
ProviderName
ProviderType
ProviderVersion
ProviderVersionId
ClassId

:
:
:
:
:
:

ddd3d232-a96f-4ac5-8f7b-250fd91fd102
Data ONTAP VSS Hardware Provider
HARDWARE
6. 4. 1. 5319
1a0989d8-b25b-439a-988a-a0f173f22046
819e04d3-809b-4657-aee0-778ca24470da

Get-NaVssWriter retrieves information about writers on the host system.

PS C:\Toolkit\2.3.0> Get-NaVssWriter
Name
WriterId
WriterInstanceId
State
LastError

:
:
:
:
: