NetApp PowerShell Toolkit 9.15.1.

2407
Installation Guide
July 2024
TABLE OF CONTENTS

Overview ............................................................................................................................................... 2

What’s new? .......................................................................................................................................... 3

Supported operating systems and installation requirements ............................................................... 3

Installation guide................................................................................................................................... 4

Windows installation ......................................................................................................................................... 4

RHEL 7.0 installation ........................................................................................................................................ 4
Ubuntu 18.04 installation ................................................................................................................................... 5

Upgrade scenario for Windows installation .......................................................................................... 7

Change Logs and Limitations .............................................................................................................. 8

Support and further information ......................................................................................................... 10

PowerShell Toolkit: Frequently asked questions ................................................................................ 10

Common issues .................................................................................................................................. 14

Version history.................................................................................................................................... 15

LIST OF TABLES
Table 1) Installation requirements for Windows ......................................................................................................... 3
Table 2) Installation requirements for Linux using RHEL ........................................................................................... 3
Table 3) Installation requirements for Linux using Ubuntu.......................................................................................... 3
Table 4) Installation requirements for macOS ............................................................................................................4
Table 5) Installation requirements for 7-Mode and ONTAP ......................................................................................... 4
Table 6) List of cmdlets that are not supported by PowerShell Toolkit 9.15.1.2407 on non-Windows operating
systems ................................................................................................................................................................. 9

Overview
NetApp® PowerShell Toolkit 9.15.1.2407 contains the PowerShell module for NetApp ONTAP®. It
supports ONTAP running on NetApp AFF or FAS systems, commodity hardware, or the cloud. The toolkit
provides end-to-end automation and storage management across ONTAP storage systems. The toolkit
also provides cross-platform support over Windows, Ubuntu, RedHat Enterprise Linux (RHEL), and
macOS.

2 NetApp PowerShell Toolkit 9.15.1.2407 © 2024 NetApp, Inc. All rights reserved.
Installation Guide
NetApp PowerShell Toolkit
The NetApp PowerShell module contains 2,340 cmdlets, enabling the storage administration of ONTAP
systems through NetApp ONTAPI. It also contains several cmdlets aimed at storage administration on
Windows hosts, including the following major features:
• Holistic end-to-end automation and management of your data center and hybrid cloud—spanning
7mode and ONTAP running on AFF or FAS arrays in your data center, NetApp ONTAP Select
running on commodity hardware, and NetApp Cloud Volumes ONTAP instances running on the public
cloud
• Complete API coverage for ONTAP 9.15.1; backwards compatible with previous ONTAP releases
• Creation, deletion, and modification of virtual disks and files
• Virtual disk and host volume space reclamation
• Creation and modification of cluster and SVM setups, making it even simpler to initialize your ONTAP
system.

What’s new?
Hydrate parameter support in NetApp PowerShell Toolkit
The "Hydrate" parameter has been introduced to improve command execution performance by offering three
options: Yes, No, and Partial.

 Yes: This is the default behavior, as it exists today. After a successful POST or PATCH request, a
GET request is made with the query parameter ?fields=**, retrieving all fields.

 No: For POST or PATCH requests, it will pass ?return_records=true, and then display only the
fields that ONTAP sets, which are usually just the keys and occasionally a few additional fields.
This option is beneficial when performance is a priority and you do not need all the field details,
avoiding the retrieval of unused fields.

 Partial: After a successful POST or PATCH request, a GET request is made with the query
parameter ?fields=*, retrieving a subset of fields. This option is useful for balancing performance
and the amount of data retrieved, reducing overhead by fetching only a subset of the fields.

PS >Get-NcVol -Hydrate <yes/no/partial>

New Rest Endpoint Support

 /security/key-manager-configs
 /support/ems/role-configs/{access_control_role.name
 /security/login/totps
 /security/key-managers/{security_key_manager.uuid}/restore
 /protocols/s3/services/{svm.uuid}/buckets/{s3_bucket.uuid}/rules/{name}

Supported operating systems and installation requirements

Table 1) Installation requirements for Windows.
Operating system Version

3 NetApp PowerShell Toolkit 9.15.1.2407 © 2024 NetApp, Inc. All rights reserved.
Installation Guide
 Microsoft Windows PowerShell 5.1 or 7.3.4 and later
Microsoft .NET Framework .NET 4.7.2 Framework
Microsoft Windows 8.1,10, Server 2012 R2,
2016, 2019
Table 2) Installation requirements for Linux using RHEL.
Operating system Version
Microsoft Windows PowerShell 7.3.4 and later
RHEL 7.0 and later
Table 3) Installation requirements for Linux using Ubuntu.
Operating system Version
Microsoft Windows PowerShell 7.3.4 and later
Operating system Version

Ubuntu 18.0.4 and later

Table 4) Installation requirements for macOS.
Operating system Version
Microsoft Windows PowerShell 7.3.4 and later
Apple macOS 10.13 and later

Table 5) Installation requirements for 7-Mode and ONTAP.

Operating system Version
NetApp ONTAP storage controllers—both 7-Mode and ONTAP 8.2.5 and later

Installation guide
Windows installation
To install the PowerShell Toolkit module for Windows, follow these steps:
1. Download and install the .NET Framework, Version 4.7.2:
https://dotnet.microsoft.com/download/dotnet-framework/net472
2. Download and install the PowerShell 7MSI installer:
https://github.com/PowerShell/PowerShell/
3. Download the NetApp.ONTAP PowerShell Toolkit zip file from the NetApp Support site and extract
the contents to the directory that you want to use.
4. Open Windows PowerShell Core, or a command prompt, and run PowerShell Core:
C:\>pwsh
Or open Windows Native PowerShell.
5. Import the NetApp.ONTAP module:
PS>Import-Module <zip file directory>\NetApp.ONTAP.psd1

4 NetApp PowerShell Toolkit 9.15.1.2407 © 2024 NetApp, Inc. All rights reserved.
Installation Guide
6. To see a list of available commands, enter the following:
PS> Get-Command -Module NetApp.ONTAP
RHEL 7.0 installation
Run the commands in a terminal session on the machine on which you want to install the software. You
can execute these commands from any directory on the machine, a specific path is not required. You
need sudo access to successfully complete the installation.

5 NetApp PowerShell Toolkit 9.15.1.2407 © 2024 NetApp, Inc. All rights reserved.
Installation Guide
To install the PowerShell Toolkit module for RHEL, follow these steps:
1. Install PowerShell:
#dotnet tool install --global PowerShell
2. Download the NetApp.ONTAP PowerShell Toolkit zip file from the NetApp Support site and extract
the contents to the directory that you want to use.

3. Open a terminal and run PowerShell Core:

#pwsh

4. Import the NetApp.ONTAP module:

PS>Import-Module <zip file directory>/ NetApp.ONTAP.psd1

5. To see a list of available commands, enter the following:

PS> Get-Command -Module NetApp.ONTAP
6 NetApp PowerShell Toolkit 9.15.1.2407 © 2024 NetApp, Inc. All rights reserved.
Installation Guide
Ubuntu 18.04 installation
Run the commands in a terminal session on the machine on which you want to install the software. You
can execute these commands from any directory on the machine, a specific path is not required. You
need sudo access to successfully complete the installation.

To install the PowerShell Toolkit module for Ubuntu, follow these steps:
1. Install PowerShell:
#dotnet tool install --global PowerShell
2. Download the NetApp.ONTAP PowerShell Toolkit zip file from the NetApp Support site and extract
the contents to the directory that you want to use.
3. Open a terminal and run PowerShell Core:
#pwsh

To see a list of available commands, enter the following:

PS> Get-Command -Module NetApp.ONTAP

PowerShell Gallery for Windows, RHEL, and Ubuntu operating systems

4. Import the NetApp.ONTAP module:

PS>Import-Module <zip file directory>/ NetApp.ONTAP.psd1

7 NetApp PowerShell Toolkit 9.15.1.2407 © 2024 NetApp, Inc. All rights reserved.
Installation Guide
8 NetApp PowerShell Toolkit 9.15.1.2407 © 2024 NetApp, Inc. All rights reserved.
Installation Guide
To directly install the PowerShell Toolkit module from PowerShell Gallery, follow these steps:
1. Install the module from PowerShell Gallery:
Install-module NetApp.ONTAP.
This downloads the module to PSModule Path.

2. Import the NetApp.ONTAP module:

Import-module NetApp.ONTAP

Upgrade scenario for Windows installation

To upgrade your PowerShell Toolkit for Windows, follow these steps:
3. Download and install the .NET Core SDK,version 3.1: https://dotnet.microsoft.com/download/dotnet-
core/3.1/
4. Download and install the PowerShell 7MSI installer:
https://github.com/PowerShell/PowerShell/
5. Download the NetApp.ONTAP PowerShell Toolkit zip file from the NetApp Support site and extract
the contents to the directory that you want to use.
6. Open Windows PowerShell, or a command prompt, and run PowerShell Core:
C:\>pwsh
7. Execute the Install.ps1 script and select the option where the toolkit must be installed.
8. Import the NetApp.ONTAP module:
PS>Import-Module <zip file directory>\NetApp.ONTAP.psd1

9 NetApp PowerShell Toolkit 9.15.1.2407 © 2024 NetApp, Inc. All rights reserved.
Installation Guide
9. To see a list of available commands, enter the following:
PS> Get-Command -Module NetApp.ONTAP

Signature Verification
Verification on windows
 After downloading the PSTK toolkit from NetApp support site, user can verify the signature of the
files.
 To verify, right click on the downloaded files of which you want to check signature for and then open
Properties.
 In the open properties windows select “Digital Signature”, It should display name of signer as
“NetApp Inc” and Timestamp of the certificate.

There is another way to check for the signature on windows.

 Import the Netapp.ONTAP module in the powershell.
 Run “Get-AuthenticodeSignature” command as show in the below image.

10 NetApp PowerShell Toolkit 9.15.1.2407 © 2024 NetApp, Inc. All rights reserved.
Installation Guide
Change Logs
 Bug Fixes
1) Get-NcQuota returning error when quota name contains “-“. FIXED
2) Get-NcEfficiency returning incorrect SnapshotUsed : FIXED
3) New-NcSnapshotMulti was not returning error when incorrect snapshot passed : FIXED

 Updates
1) Get-NcSnapshot now supports wildcard volume name : UPDATE
a. Get-ncSnapshot -Volume * -SnapName <snapshot-name>

Limitations
Some of the native host features for Windows are not supported with this toolkit over Linux and Ubuntu or
other operating systems. See the following table for the list of cmdlets that are not supported in a
nonWindows environment:
Table 6) List of cmdlets that are not supported by PowerShell Toolkit 9.15.1.2407 on non-Windows operating
systems.
Cmdlet Description

Add a connection to an existing iSCSI session.

Add-NcHostIscsiConnection

Establish a connection to a target discovered by the iSCSI Initiator.

Connect-NcHostIscsiTarget

Copy a file between LUNs mounted on a Windows host, or within a LUN

Copy-NcHostFile mounted on a Windows host.

Disconnect the host from an iSCSI target.

Disconnect-
NcHostIscsiTarget

Remove one or all mount points from a Windows volume.

Dismount-NcHostVolume

Perform a quick NTFS format on an existing Windows volume.

Format-NcHostVolume

Lists all disks on the local host that are served by ONTAP LUNs.
Get-NcHostDisk

Get FC adapters on the host machine.

Get-NcHostFcAdapter

Get information about the host FC connections to the current controller.

Get-NcHostFcConnectivity

Get information about the Microsoft iSCSI Initiator on the host machine.
Get-NcHostIscsiAdapter

Get current iSCSI sessions on the host machine.

Get-NcHostIscsiSession

11 NetApp PowerShell Toolkit 9.15.1.2407 © 2024 NetApp, Inc. All rights reserved.
Installation Guide
 Get the targets discovered by the iSCSI Initiator.
Get-NcHostIscsiTarget

Get Windows volume information.

Get-NcHostVolume

Get a list of all Volume Shadow Copy Service (VSS) providers on the current
Get-NcVssProvider system.
Get a list of completed shadow copies in the system that reside in the given
Get-NcVssSnapshot context.

Get a list of available VSS writers on the current system.

Get-NcVssWriter

Initialize a Windows disk with basic partition layout information.

Initialize-NcHostDisk

Reclaim free space on a Windows volume that is hosted on an ONTAP LUN.

Invoke-
NcHostVolumeSpaceReclaim

Create a VSS shadow copy NetApp Snapshot™ set for the given volumes.
Invoke-NcVssBackup

Add a drive letter or empty folder mount point to an existing Windows

Mount-NcHostVolume volume.

Cmdlet Description
Create a new Windows volume on an existing disk.
New-NcHostVolume

Delete a file, completely reclaiming the space it consumed on the storage

Remove-NcHostFile controller.

Remove a connection from an iSCSI session.

Remove-
NcHostIscsiConnection

Remove a Windows volume from a disk.

Remove-NcHostVolume

Restore a single file from a Snapshot copy.

Restore-NcHostFile

Set basic Windows disk options (offline, online, partition style).

Set-NcHostDisk

Grow or shrink a Windows volume.

Set-NcHostVolumeSize

Start a Windows disk rescan operation to force enumeration of any recently

Start-NcHostDiskRescan added or removed disks.

Wait for a specific disk to appear or wait for ongoing changes to the disk list
Wait-NcHostDisk to settle.

Create a LUN from a virtual hard disk (VHD) or Microsoft Hyper-V virtual hard
ConvertTo-NcLun disk (VHDX).
Convert a Virtual Machine Disk (VMDK) file, a VHDX file, a dynamic VHD file,
ConvertTo-NcVhd or an ONTAP LUN into a VHD file.

12 NetApp PowerShell Toolkit 9.15.1.2407 © 2024 NetApp, Inc. All rights reserved.
Installation Guide
 Convert a VMDK file, a fixed VHD file, or an ONTAP LUN into a VHDX file.
ConvertTo-NcVhdx

Convert a VHD or VHDX file into a VMDK file.

ConvertTo-NcVmdk

Dismount a VHD file from the local host.

Dismount-NcVirtualDisk

List Hyper-V virtual machines (VMs) running on the local host along with all
Get-NcHyperV ONTAP storage resources that they are using.

Get the disk partitions of the given VHD and determine if they are aligned.
Get-
NcVirtualDiskAlignment

Reclaim space on a virtual disk residing on an ONTAP LUN.

Invoke-
NcVirtualDiskSpaceReclaim

Mount a VHD file on the local host.

Mount-NcVirtualDisk

Rapidly create a VHD file on a LUN or CIFS share mounted on a Windows host.
New-NcVirtualDisk

Perform an alignment operation on a misaligned VHD file.

Repair-
NcVirtualDiskAlignment

Resize a VHD or VHDX format virtual disk.

Set-NcVirtualDiskSize

Cmdlet Description

ConvertFrom- Convert a serialized .NET object back to a native one.

SerializedString, Note: This cmdlet is supported for non-Windows operating systems, but
backward compatibility is not supported. An object serialized with an older
toolkit will not covert back to a native one.

Support and further information

The PowerShell Toolkit is community supported. To create a new discussion in the appropriate
community, see NetApp.ONTAP related discussions.

PowerShell Toolkit: Frequently asked questions

How do I import the PowerShell Toolkit (PSTK) module in PowerShell?

Use the cmdlet: Import-Module NetApp.ONTAP

Howdo I find help for PSTK?

To find help, use the following cmdlets:
• Get-NcHelp to view the syntax and examples for all the available PSTK cmdlets.
• Get-NcCommand to view all the available PSTK cmdlets.
• Get-NcHelp -CategoryList to view the available categories in PSTK.
• Get-NcCommand -Category <category> to view all the cmdlets of a particular category.

13 NetApp PowerShell Toolkit 9.15.1.2407 © 2024 NetApp, Inc. All rights reserved.
Installation Guide
• Get-Help <cmdlet_name> -full to view full help for a particular cmdlet.
• Get-Help <cmdlet_name> -examples to view an example for a particular cmdlet.
How do I connect to a NetApp storage system by using PSTK?

Use the cmdlet: Connect-NcController

Can I connect to an SVM’s management interface?

Yes. Use the -vserver parameter in the cmdlet Connect-NcController.

Can I connect to multiple controllers?
Yes. After connecting to multiple controllers, use the -Controllerparameter in every cmdlet to execute
that cmdlet against a particular controller.
How do I know which cmdlets to run against the controller and which cmdlets to run against the
SVM?
Each cmdlet is associated with a family (cluster or vserver). To view the family for the cmdlets, use
cmdlets Get-NcHelp or Get-NcCommand. If the family is cluster for a cmdlet, then you must direct
the cmdlet to the cluster. If the family is vserver for a cmdlet, then you must direct the cmdlet to the
SVM. If the family is cluster, vserver for a cmdlet, then you can direct the cmdlet to both the cluster
and SVM.
How do I gather the basic information of the controller?

Use cmdlets of the category system. Use the cmdlet Get-NcCommand -Category system to list
available cmdlets in this category.
How do I check the users of the controller?
Use the cmdlet: Get-NcUser
Can I send CLI commands to the controller from PSTK?
Yes. Use the cmdlet: Invoke-NcSSH, Invoke-NcCli
Can I call ONTAPI commands from PSTK?

Yes. Use the cmdlet: Invoke-NcSystemApi

How do I format the output of the cmdlet Invoke-NcSSH?
PSTK invokes Secure Shell (SSH) to execute CLI commands on the controller and cannot format the
output. Use regular expressions to match the pattern against the output and create a custom object to
hold the output.
Why are the sizes returned by Get-NcAggr, Get-NcVol and Get-NcLun different when they display
on the console than when they are exported to a CSV or stored in a local variable?
When these cmdlets output the size to the console, it is formatted. But when it is stored in a local variable
or exported to csv format, the size is returned in bytes. Use the cmdlet ConvertTo-FormattedNumber
to format the size for your requirements.
Does PSTK support conversion of dynamic VHD?
No. PSTK only supports fixed VHD.
How do I create a credential object?
Use the following cmdlets to create a credential object:
$password = ConvertTo-SecureString -AsPlainText -Force <password>
$credential = new-object management.automation.pscredential <username>, $password
12 NetApp PowerShell Toolkit 9.14.1.2401 Installation Guide © 2024 NetApp, Inc. All rights reserved.
Use $credential as the credential object to pass to the -Credential parameter in any cmdlet that
supports this parameter.
Can I download an older version of PSTK?
You can download only the latest version of PSTK from NetApp ToolChest. The latest version always
maintains 100% backward compatibility. Releases PSTK 9.7.1 and later are also available on the
PowerShell Gallery.
How do I call REST APIs instead of ONTAPIs?
If you are running ONTAP 9.10 or later and the REST API equivalent is available, by default, the toolkit
invokes a cmdlet by using the REST API. Otherwise, the toolkit calls the ONTAPI only.
How do I call ONTAPIs instead of REST APIs?
To execute cmdlets by using ONTAPI, use the -ONTAPI parameter:
Connect-NcController 10.237.145.182
Get-NcVserver -Name vs0 -ONTAPI

How do I execute ONTAPI for all cmdlet calls or a global connection?

Set a global connection to execute all cmdlets with ONTAPI:
Connect-NcController ControllerIP -ONTAPI Get-NcVserver
-Name vs0

How do I execute an ONTAPI call for a particular cmdlet?

Use the -ONTAPI parameter followed by the cmdlet:
Get-NcVserver -Name vs0 -ONTAPI

Why are some properties missing in the REST API?

Some properties are missing in the REST API because there is no REST API equivalent available for
those cmdlets. For information about which properties are available, see ONTAP REST API Online
Reference. For information about which properties have no REST API equivalent, see ONTAP 9.15.1
ONTAPI to REST API mapping information.
Are there REST API endpoints with no equivalent cmdlet?
Yes. There are currently no equivalent cmdlets for the following endpoints:
• /application/applications/{application.uuid}/components
• /application/applications/{application.uuid}/components/{component.uuid}/snapshots
• /application/applications/{application.uuid}/components/{component.uuid}/snapshots/{uuid}
• /application/applications/{application.uuid}/components/{component.uuid}/snapshots/{uuid}/restore
• /application/applications/{application.uuid}/components/{uuid}
• /cluster/chassis
• /cluster/licensing/capacity-pools
• /cluster/mediators
• /cluster/mediators/{uuid}
• /cluster/metrocluster/dr-groups/{id}
• /cluster/metrocluster/interconnects/{node.uuid}/{partner_type}/{adapter}
• /cluster/metrocluster/nodes/{node.uuid}
• /cluster/metrocluster/operations/{uuid}
• /cluster/nodes/{uuid}/metrics
• /network/ethernet/switch/ports

13 NetApp PowerShell Toolkit 9.14.1.2401 Installation Guide © 2024 NetApp, Inc. All rights reserved.
• /network/fc/fabrics/{fabric.name}/switches
• /network/fc/fabrics/{fabric.name}/switches/{wwn}
• /network/fc/fabrics/{fabric.name}/zones/{name}
• /network/fc/fabrics/{name}
• /security/azure-key-vaults/{azure_key_vault.uuid}/rekey-external
• /security/azure-key-vaults/{uuid}
• /security/azure-key-vaults/{uuid}/rekey-internal
• /security/azure-key-vaults/{uuid}/restore
• /security/gcp-kms
• /security/gcp-kms/{gcp_kms.uuid}/rekey-external
• /security/gcp-kms/{uuid}
• /security/gcp-kms/{uuid}/rekey-internal
• /security/gcp-kms/{uuid}/restore
• /security/key-manager-configs
• /security/key-managers/{security_key_manager.uuid}/keys/{node.uuid}/key-ids/{key_id}
• /security/key-stores
• /support/auto-update
• /support/auto-update/configurations
• /support/auto-update/configurations/{uuid}
• /support/auto-update/updates
• /support/auto-update/updates/{uuid} /application/applications

What should I do if a property is missing but it is important for my workflow?

If you require a missing property, send an email to [email protected].
How do I know if a cmdlet is called with ONTAPI or with REST API?
For every cmdlet, you can refer to the OntapiUsedproperty available under the controller object. If the
value is false, REST API is invoked for the cmdlet execution.
Is there object level support available with the -Template parameter?
Yes. You can now filter or query records, as shown in the following example.
To initialize the object, use the -Template parameter along with the -Fill parameter and then set the
property on which you need to filter. For example, set Snaplock.Type to enterprise.
PS H:\ NetApp.ONTAP> $a=Get-NcVol -Template -Fill
PS H:\ NetApp.ONTAP> $a.Snaplock.Type = "enterprise"

PS H:\ NetApp.ONTAP> Get-NcVol -Query $a

How do I find information about which parameters are supported with ONTAPI, with REST API, or
with both?
To retrieve the complete details about a cmdlet, including parameters supported in the REST API and
ONTAPI and its supported type, enter the following:
Get-Help Get-NcVserver -Full

14 NetApp PowerShell Toolkit 9.14.1.2401 Installation Guide © 2024 NetApp, Inc. All rights reserved.
Common issues
• Issue While converting VHDs by using the cmdlets ConvertTo-NcVmdk and ConvertTo-NcVhd,
you get the following error: Source and destination offsets are not WAFL
blockaligned.
Workaround: The size of the disk must be a multiple of 4Kb. Resize the size of the disk to a multiple
of 4Kb by using the cmdlet Resize-VHD.
• Issue: While converting a dynamic VHD to VMDK by using the cmdlet ConvertTo-NcVmdk, you get
the following error: Specified argument was out of the range of valid values.
File is not a fixed-size VHD.
Workaround: PSTK does not support dynamic VHD conversion. Convert the dynamic VHD to fixed
by using the cmdlet Convert-VHD.
• Issue: While converting virtual disks with a size greater than 128MB by using cmdlets
ConvertToNcVhd and ConvertTo-NcVmdk in ONTAP 9.0 and later, you get an error mentioning
conversion failure.
Workaround: Follow these steps to resolve this known issue:
a. Take a Snapshot copy of the volume on which the VHD or VMDK resides.
b. Pass the Snapshot copy as a parameter to the cmdlet ConvertTo-NcVhd or ConvertTo-
NcVmdk
c. Delete the Snapshot copy created after the conversion operation succeeds.
• Issue: Some cmdlets throw errors that read Unable to find API with earlier releases of ONTAP
although the syntax for the cmdlet is proper.
Workaround: Some newer cmdlets are meant only for ONTAP 9.15.1 and do not work for earlier
releases of ONTAP. See the release notes for more information.
• Issue: When you use file names with non-ASCII characters ina volume, they are not handled
correctly by the cmdlets.
Workaround: Use UTF-8 instead.
Issue: You cannot load the file or assembly, log4net, Version=2.0.11.0,
Culture=neutral, PublicKeyToken=669e0ddf0bb1aa2a, and cannot find or load a specific file
(0x80131621).
Workaround: This problem is caused by a log4net assembly in the Global Assembly Cache (GAC).
The assembly of another version is already present and, as a result, is causing conflict. To resolve
this issue, remove another module that consumes log4net (such as PowerCLI) and import the
NetApp.ONTAP module. For more information, see the PowerShell-ProLiant SDK issues page.
• Issue: While importing the module, you get the following error: The following error occurred
while loading the extended type data file: Error in TypeData
"DataONTAP.Types.Iscsi.IscsiPortalListEntryInfo": The member Port is
already present. Error in TypeData…
Workaround: This problem occurs when you try to import the module that is using the alias name
NetApp.ONTAP, and the session already has an imported module named DataONTAP. To resolve
this issue, remove the existing imported module.
• Issue: While executing the cmdlet Add-NcCredential on a Linux-based operating system, you get
the following error: Add-NcCredential: Could not save credentials for <xyz>.
Please try again with root user.

15 NetApp PowerShell Toolkit 9.14.1.2401 Installation Guide © 2024 NetApp, Inc. All rights reserved.
 Workaround: This error occurs because there are write issues with non-root users on Linux-based
operating systems. To resolve this issue, execute the su command and enter your password. Next,
launch PowerShell 7 by using the pwsh command and execute the Add-NcCredential cmdlet.
• Issue: The -Force parameter is not supported with REST API -Force
Workaround: To use the -Force parameter, use it with the -Zapi parameter for a cmdlet.

Version history
Version Date Document history
1.0 July 2024 Installation guide

16 NetApp PowerShell Toolkit 9.14.1.2401 Installation Guide © 2024 NetApp, Inc. All rights reserved.
Copyright Information
Copyright © 2024 NetApp, Inc. All Rights Reserved. Printed in the U.S. No part of this document covered
by copyright may be reproduced in any form or by any means—graphic, electronic, or mechanical,
including photocopying, recording, taping, or storage in an electronic retrieval system—without prior
written permission of the copyright owner.
Software derived from copyrighted NetApp material is subject to the following license and disclaimer:
THIS SOFTWARE IS PROVIDED BY NETAPP “AS IS” AND WITHOUT ANY EXPRESS OR IMPLIED
WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE, WHICH ARE HEREBY
DISCLAIMED. IN NO EVENT SHALL NETAPP BE LIABLE FOR ANY DIRECT, INDIRECT,
INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF
THE POSSIBILITY OF SUCH DAMAGE.
NetApp reserves the right to change any products described herein at any time, and without notice.
NetApp assumes no responsibility or liability arising from the use of products described herein, except as
expressly agreed to in writing by NetApp. The use or purchase of this product does not convey a license
under any patent rights, trademark rights, or any other intellectual property rights of NetApp.
The product described in this manual may be protected by one or more U.S. patents, foreign patents, or
pending applications.
Data contained herein pertains to a commercial product and/or commercial service (as defined in FAR
2.101) and is proprietary to NetApp, Inc. The U.S. Government has a non-exclusive, non-transferrable,
non-sublicensable, worldwide, limited irrevocable license to use the Data only in connection with and in
support of the U.S. Government contract under which the Data was delivered. Except as provided herein,
the Data may not be used, disclosed, reproduced, modified, performed, or displayed without the prior
written approval of NetApp, Inc. United States Government license rights for the Department of Defense
are limited to those rights identified in DFARS clause 252.227-7015(b).
Trademark Information
NETAPP, the NETAPP logo, and the marks listed at http://www.netapp.com/TM are trademarks of
NetApp, Inc. Other company and product names may be trademarks of their respective owners.

17 NetApp PowerShell Toolkit 9.14.1.2401 Installation Guide © 2024 NetApp, Inc. All rights reserved.