Add-SmStorageConnection
Creates a new storage system connection.
Syntax
Add-SmStorageConnection [-Storage] <String> [-Port] <UInt16> [-Protocol] <ConnectProtocol> [-Timeout] <Int32> [-Credential] <PSCredential> [-PreferredIP] <String> [-DisableAsupOnFailure] <> [-DisableSysLog] <> [-Type] <StorageSystemType> [-PlatformType] <String> [-NetAppAccountName] <String> [-CredentialName] <String> [-CredentialId] <bigint(20)> [-ResourceGroup] <String> [-IsSecondary] <>
Detailed Description
Creates a new storage system connection. You must create your storage system connection in advance of performing any provisioning or data protection jobs.
Parameters
Name | Description | Required? | Pipeline Input | Default Value |
---|---|---|---|---|
Storage |
true |
true (ByPropertyName) |
||
Port |
Specifies the port for the storage system connection. 80 is the default port for HTTP and 443 is the default port for HTTPS. |
false |
true (ByPropertyName) |
|
Protocol |
Specifies the communication protocol you want to use to connect to the storage system. Valid values is: HTTPS. |
true |
true (ByPropertyName) |
|
Timeout |
Specifies the storage system connection timeout in seconds. The default timeout is 60 seconds. However, in a scaled environment,increasing the timeout to 300 seconds is recommended. |
false |
true (ByPropertyName) |
60 |
Credential |
Specifies the storage system credentials. You must have created valid storage system credentials in advance. |
true |
true (ByPropertyName) |
|
PreferredIP |
Specifies the preferred IP address for the storage system management or data LIF IP address. |
false |
true (ByPropertyName) |
|
DisableAsupOnFailure |
Disables Auto Support in case of any failure. |
false |
true (ByPropertyName) |
|
DisableSysLog |
Disables system log. |
false |
true (ByPropertyName) |
|
Type |
Specifies the type of storage being added. Valid value are DataOntap and AzureNetAppAccount. |
false |
true (ByPropertyName) |
|
NetAppAccountName |
Specifies the Azure NetApp Account Name. |
true |
true (ByPropertyName) |
|
CredentialName |
Specifies Azure NetApp Credential name. |
false |
true (ByPropertyName) |
|
CredentialId |
Specifies Azure NetApp Credential ID. |
false |
true (ByPropertyName) |
|
ResourceGroup |
Specifies resource group. |
true |
true (ByPropertyName) |
|
SubscriptionId |
Specifies Subscription Id. |
true |
true (ByPropertyName) |
|
PlatformType |
This optional parameter specifies the SVM platform type for licensing purposes. Possible values are Hardware and Software. Hardware indicates that you are using a FAS or All Flash FAS plaform. Software indicates that you are using ONTAP Cloud or ONTAP Select.If you specify Type as ONTAP SVM as the storage connection type,and you do not specify PlatformType, the default value is set to Hardware. |
false |
true (ByPropertyName) |
|
IsSecondary |
false |
true (ByPropertyName) |
Examples
Example 1: Creating a new storage system connection
Add-SmStorageConnection -SVM neeraj_vs1 -Protocol Https -Timeout 60
This example syntax creates a new storage system connection.
cmdlet Add-SmStorageConnection at command pipeline position 1 Supply values for the following parameters: (Type !? for Help.) Credential UserName: Password: Port: 443 TransportType : Https ModifyTime : 1/1/0001 12:00:00 AM Mode: OntapiMajorVersion : OntapiMinorVersion : Version : NetApp Release 8.2.1RC2X9 Cluster-Mode: Mon Jan 13 09:30:32 PST 2014 StorageSystemOSType : DataOntap Passphrase : Id : 0 Timeout : 60 Uuid: OperationContext: PreferredIpAddress : Aliases : {neeraj_vs1-mc, neeraj_vs1} SmIPAddresses : {SMCoreContracts.SmIPAddress, SMCoreContracts.SmIPAddress, SMCoreContracts.SmIPAddress, SMCoreContracts.SmIPAddress...} IPAddresses : {172.17.124.165, 172.17.124.165, 172.17.124.165, 172.17.124.165...} Name: test_vs1 IsResolved : True IsValid : True Identity: test_vs1
Example 2: Creating a new Azure NetApp Account using credential name
Add-SmStorageConnection -Type AzureNetAppAccount -NetAppAccountName "azureNetappAccount1" -SubscriptionId 5199ff02-31d1-4a57-afd1-3039bcbdf9aa -CredentialName "AzureCred1" -ResourceGroup "azure_rg1"
This example syntax creates a new Azure NetApp Account using credential name.
Example 3: Creating a new Azure NetApp Account using credential ID
Add-SmStorageConnection -Type AzureNetAppAccount -NetAppAccountName "azureNetappAccount1" -SubscriptionId 5199ff02-31d1-4a57-afd1-3039bcbdf9aa -CredentialId 1 -ResourceGroup "azure_rg1"
This example syntax creates a new Azure NetApp Account using credential ID.