Microsoft Virtualization Discussions

Data ONTAP PowerShell Toolkit 3.2

Hi PowerShell community,

Glad to announce availability of Data ONTAP PowerShell Toolkit Version 3.2.

The Data ONTAP PowerShell Toolkit can be downloaded from the NetApp support site:




Version 3.2 release notes:

Major features

  • Data ONTAP 8.3 API support

Toolkit 3.2 includes API coverage for Data ONTAP 8.3.  This includes 126 new cmdlets and 31 cmdlets with new parameters. There are several categories introduced in Data ONTAP 8.3 and Toolkit 3.2 introduces two of them, namely MetroCluster and Storage Pool.


The following clustered Data ONTAP categories contain new cmdlets:

  • aggr (16 cmdlets)
  • cifs (13 cmdlets)
  • metrocluster (new category - 26 cmdlets)
  • net (48 cmdlets)
    • ipspace (4 cmdlets)
    • firewall (10 cmdlets)
    • failover group (4 cmdlets)
    • subnet (5 cmdlets)
    • port broadcast domain (7 cmdlets)
    • route (4 cmdlets)
    • arp (5 cmdlets)
    • ndp (9 cmdlets)
  • storage pool (new category - 8 cmdlets)
  • snapmirror (1 cmdlets)
  • vserver (7 cmdlets)


  • Get-NaDiskwill use storage-disk-get-iter when available.
  • ConvertTo-NaVhdx will create a fully-allocated dynamic VHDX instead of a fixed-size VHDX.
  • Invoke-NcSysstat now works with Data ONTAP 8.3
  • Fibre channel port information has been added to the output of Get-NaHostFcAdapter.


  • 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.


Check out "Making the Most of Data ONTAP PowerShell Toolkit" for more details on the new features.  If you're new to PowerShell or the Toolkit, you might want to start with our "Getting Started" slides



Re: Data ONTAP PowerShell Toolkit 3.2



Is connect-NcController -RPC an option yet?




Re: Data ONTAP PowerShell Toolkit 3.2

Hello Leon,


connect-NcController -RPC  options is not supported as RPC based connectivity option is not supported in C-mode, its supported only in 7-mode.


Re: Data ONTAP PowerShell Toolkit 3.2

Hi Vinith,


Ok. Why is RPC dropped in cDOT? 



Re: Data ONTAP PowerShell Toolkit 3.2

Quick question. Are the new cmdlets also working for Ontap 8.2? fe get-ncaggrspace

Re: Data ONTAP PowerShell Toolkit 3.2


The new cmdlets introduced in Data ONTAP PowerShell Toolkit 3.2 work only on Data ONTAP 8.3. They will not work with older versions of Data ONTAP.

In the particular case of Get-NcAggrSpace, you can get the same information on DataONTAP 8.2 by using the AggrSpaceAttributes property of Get-NcAggr cmdlet. You can define a function like

Function Get-NcAggrSpace-SN($inp) {
     $res = Get-NcAggr $inp
    foreach ($a in $res) {
            Write-Output Name: $a.Name
            Write-Output $a.AggrSpaceAttributes

and now use "Get-NcAggrSpace-SN" as a command to get the same information for older Data ONTAP versions as "Get-NcAggrSpace" gives on DataONTAP 8.3

Re: Data ONTAP PowerShell Toolkit 3.2


where can i get the release notes for the 3.2 Tollkit ?

i want to see what is new.




Re: Data ONTAP PowerShell Toolkit 3.2

Import the DataONTAP module and type "Show-NcHelp". This takes few minutes and opens up a html page in the default browser. A "Release Notes" link must be available in there.

Re: Data ONTAP PowerShell Toolkit 3.2


Thank you for the replay.

Cant i read it without installing ?



Re: Data ONTAP PowerShell Toolkit 3.2

Of course, you can read it from here as well - "Check out "Making the Most of Data ONTAP PowerShell Toolkit" for more details on the new features".

Re: Data ONTAP PowerShell Toolkit 3.2

Great Thanks.

Re: Data ONTAP PowerShell Toolkit 3.2

Unable to access provide location.


Error message as follows:


Unauthorized Access

You have come to a page or module to which you do not have permission.

If you believe you have proper permissions and have reached this notification in error, please submit Feedback.

If you have an urgent technical issue related to a NetApp product, please contact NetApp's Global Support Center

Re: Data ONTAP PowerShell Toolkit 3.2

Hello PSTK Community


where can i post Feedback to the actual Release 3.2.1 of the PSTK??


as an example:

a) i try to create a cifs share with share-property "Continuously Available", it seems the is not possible with PSTK, but is supported in OnTAP API

b) I likt to use the 8.3 new Failover-Policy with a new created network interface failover-policy can be "broadcast-domain-wide" or "sfo-partner-only"


These options or properties i do not find in the PowerShell ToolKit


Re: Data ONTAP PowerShell Toolkit 3.2



Thank you for taking the time to share your feedback. I would suggest using this for posting feedback regarding the 3.2.1 release. We do not have a separate thread monitored for feedback, but the usual practice is to provide feedback in the thread where release was announced.


Also please specify the share property as "continuously_available" instead of "Continuously Available" (example given below). Regarding the network interface issue, could you please provide more details? Like do you wish to set the failover policy while creating a new network interface  (using New-NcNetInterface) or are you attempting to modify an existing lif (using Set-NcNetInterface)?



PS C:\Users\aparajir\Perforce\aparajir_BTC_pstk_3\main> Add-NcCifsShare -Name cifsvol1 -Path /cifs_vol -VserverContext cifs_vs -ShareProperties "continuously_available"

CifsServer                ShareName       Path                   Comment
----------                   -------                 ----                    -------
PSTK-FILER              cifsvol1            /cifs_vol


PS C:\Users\aparajir\Perforce\aparajir_BTC_pstk_3\main> Get-NcCifsShare cifsvol1 -VserverContext cifs_vs | select *

NcController                    :
Vserver                         : cifs_vs
Acl                             : {Everyone / Full Control}
AttributeCacheTtl               :
CifsServer                      : PSTK-FILER
Comment                         :
DirUmask                        :
FileUmask                       :
ForceGroupForCreate             :
MaxConnectionsPerShare          : 4294967295
OfflineFilesMode                : manual
Path                            : /cifs_vol
ShareName                       : cifsvol1
ShareProperties                 : {continuously_available}
SymlinkProperties               : {enable}
Volume                          : cifs_vol
VscanFileopProfile              : standard
AttributeCacheTtlSpecified      : False
DirUmaskSpecified               : False
FileUmaskSpecified              : False
MaxConnectionsPerShareSpecified : True


Hope this helps!

Re: Data ONTAP PowerShell Toolkit 3.2

Hello And thanks for the help


so it looks like the creation of a cifs share with -Share-Properties "continuously_available" does work?

Then it is just not documented in the help



yes, i try to create a new lif and would like to give the failover-policy either "sfo-partner-only" or "broadcast-domain-wide"

New-NcNetInterface nl_"$SMBv3_bkp_vserver_svm_name"_ha01_n1 -Vserver "$SMBv3_bkp_vserver_svm_name" -Role data -DataProtocols cifs -Node "$nodename_ha01_n1" -Port "$SMBv3_sto_portname" -Address "$SMBv3_bkp_data_lif_ha01_n1" -Netmask "$SMBv3_sto_netmask" -AutoRevert 1 -FailoverGroup "$SMBv3_sto_bdcst_domain" -AdministrativeStatus up


So thank you, it seems to work, but i did not find it in the help files.....


Thanks for your help!

Re: Data ONTAP PowerShell Toolkit 3.2

Hello, yeah - the help isn't updated with all the values possible here. We've made a note to set this right.

As a general rule, if you have hyphenated strings that can be provided in cluster shell, then the same will be replaced by a string with underscore characters (instead of hyphen).

So in your case, you could augment the cmdlet with -FailoverPolicy "sfo_partner_only" or with -FailoverPolicy "broadcast_domain_wide".


Also, feel free to create a new discussion thread, possibly with the cmdlet name as title to seek attention or help. That way, it becomes easy for newer people to be able to search and get their queries answered. Thanks once again for bringing this to our notice. Appreciate it.

Cloud Volumes ONTAP
Review Banner
All Community Forums