QuantaStor PowerShell Command Reference: Difference between revisions

From OSNEXUS Online Documentation Site
Jump to navigation Jump to search
mNo edit summary
mNo edit summary
Line 19: Line 19:
There are two current environment variables <code>QSPath</code> and <code>QSLogin</code>. Unless set, <code>QSPath</code> is <code>http://localhost/</code>. Commands for setting these variables in PowerShell are below:
There are two current environment variables <code>QSPath</code> and <code>QSLogin</code>. Unless set, <code>QSPath</code> is <code>http://localhost/</code>. Commands for setting these variables in PowerShell are below:
  $Env:QSPath = "http://x.x.x.x:y"
  $Env:QSPath = "http://x.x.x.x:y"
$Env:QSLogin = "username:password"
For example,
PS /> $Env:QSPath = "http://10.0.8.242"
PS /> $Env:QSLogin = "exampleUser:abcd1234"


== Commands ==
== Commands ==
Line 31: Line 36:
To list all storage pools:
To list all storage pools:
  Enum-StoragePool
  Enum-StoragePool
$Env:QSLogin = "username:password"


== Example ==
== Example ==
[[File:PowerShellExample.png|border|1200px|Example usage]]
[[File:PowerShellExample.png|border|1200px|Example usage]]

Revision as of 00:12, 16 November 2022

PowerShell installation methods

PowerShell is supported on Windows, Linux, and Mac. In addition to system packages and snaps provided by Microsoft, it can also be installed with a functioning recent dotnet SDK as a global tool (If you already have the .NET Core SDK installed):

dotnet tool install --global PowerShell

If you do not have the the .NET Core SDK installed and are on a much older version, then you can use the MSI installation package found at the following URL: https://learn.microsoft.com/en-us/powershell/scripting/install/installing-powershell-on-windows?view=powershell-7.3#msi

Recommended versions

To use the QuantaStor PowerShell module, you must be on PowerShell 7 or newer and dotnet 6 or newer.

To check what version you have installed, execute the following command from a PowerShell console: $PSVersionTable

QuantaStor PowerShell module installation

Our module is hosted on the PowerShell gallery and can be found here. Installation is easily done through PowerShell:

Install-Module -Name QuantaStor.PowerShell

Environment Variables

There are two current environment variables QSPath and QSLogin. Unless set, QSPath is http://localhost/. Commands for setting these variables in PowerShell are below:

$Env:QSPath = "http://x.x.x.x:y"
$Env:QSLogin = "username:password"

For example, PS /> $Env:QSPath = "http://10.0.8.242" PS /> $Env:QSLogin = "exampleUser:abcd1234"

Commands

The commands can be slightly renamed from other instances to be closer to PowerShell standards. For example instead of UserEnum there is Enum-User. All commands can be listed with:

Get-Command -Module QuantaStor.PowerShell

And help for a command can be viewed with:

Get-Help COMMAND

For example to view the parameters of Add-User:

Get-Help Add-User

To list all users:

Enum-User

To list all storage pools:

Enum-StoragePool

Example

Example usage