Data ONTAP® PowerShell Toolkit

Switch to Data ONTAP 7-mode documentation.

Cmdlet: Invoke-NcSsh


NAME
Invoke-NcSsh

SYNOPSIS
Send a Data ONTAP CLI command via SSH.

SYNTAX
Invoke-NcSsh -Command <String[]> [-Credential <PSCredential>] [-Port <Int32>
] [-Timeout <Int32>] [-WhatIf] [-Confirm] [<CommonParameters>]

Invoke-NcSsh -Name <String> -Command <String[]> [-Credential <PSCredential>]
[-Port <Int32>] [-Timeout <Int32>] [-WhatIf] [-Confirm] [<CommonParameters>
]

Invoke-NcSsh -Controller <NcController[]> -Command <String[]> [-Credential <
PSCredential>] [-Port <Int32>] [-Timeout <Int32>] [-WhatIf] [-Confirm] [<Com
monParameters>]


DESCRIPTION
Send a Data ONTAP CLI command via SSH.

This cmdlet is useful for querying or manipulating Data ONTAP if a more spec
ific PowerShell cmdlet is not available. It may also be used to to interact
with Data ONTAP in lieu of opening a terminal connection to the controller.


PARAMETERS
-Command <String[]>
The command string to send to Data ONTAP. If the command string contain
s hyphens, enclose the command in quotes lest PowerShell attempt to inte
rpret those as cmdlet arguments.

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

-Credential <PSCredential>
Use this argument to explicitly provide SSH credentials for authenticati
ng with Data ONTAP. If credentials are provided, they take precedence o
ver any other credentials that may be available. If not provided, the c
mdlet will look for valid credentials from either the specified NcContro
ller object or $global:CurrentNcController as appropriate. Failing that
, credentials will be sought in the Toolkit's credential cache.

Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false

-Port <Int32>
The port on which to connect to the storage controller.

Required? false
Position? named
Default value 22
Accept pipeline input? false
Accept wildcard characters? false

-Timeout <Int32>
Connection timeout in milliseconds.

Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false

-WhatIf


Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false

-Confirm


Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false

-Name <String>
The name or address of the controller to connect to. If a hostname is s
pecified, it must be resolvable to an IP address. Specify either this a
rgument or the -Controller argument, but not both.

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

-Controller <NcController[]>
The controller(s) to connect to, embodied in an NcController object as r
eturned by Connect-NcController. Specify
either this argument or the -Name argument, but not both.

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

<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer and OutVariable. For more information, type,
"get-help about_commonparameters".

INPUTS



OUTPUTS
DataONTAP.C.PowerShell.SDK.Cmdlets.MultilineStr


NOTES


Category: toolkit

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

C:\PS>Invoke-NcSsh system health status show


Invoke the cluster CLI command 'system health status show'.


NcController : 10.61.172.155
Value : Status
---------------
OK



RELATED LINKS
Connect-NcController







 Data ONTAP® PowerShell Toolkit