CVPowershellSDK

CVPowershellSDK is a Windows PowerShell package for Commvault software.

CVPowershellSDK uses the Commvault REST API to perform operations on a CommCell via the WebConsole.

Requirements

• Windows PowerShell version 5.1 or above
• Commvault Software v11 SP16 or later release with WebServer installed

Installation

After downloading and extracting the package, if necessary unblock the downloaded PowerShell modules:

• PS C:\Users\UserName\Downloads> dir -Recurse .\CVPowershellSDK\ | Unblock-File
• See: https://docs.microsoft.com/en-us/powershell/module/microsoft.powershell.utility/unblock-file?view=powershell-6

Online Install

To install the modules for all users:

• Launch a PowerShell session with Administrator privileges and execute: C:\Users\UserName\Downloads\CVPowershellSDK>.\Install-CVModules.ps1 -Scope AllUsers (this is default)

To install the modules for the current user only:

• Launch a PowerShell session with current user privileges and execute: C:\Users\UserName\Downloads\CVPowershellSDK>.\Install-CVModules.ps1 -Scope CurrentUser

Offline Install

To install the modules in 'Offline' mode for all users:

• Launch a PowerShell session with Administrator privileges and execute: C:\Users\UserName\Downloads\CVPowershellSDK>.\Install-CVModules.ps1 -Scope AllUsers -Offline -PersistModulePath
• The 'PersistModulePath' switch will update the system $env:PSModulePath environment variable to persist access to the Commvault modules across PowerShell sessions.

To install the modules in 'Offline' mode for the current user only:

• Launch a PowerShell session with current user privileges and execute: C:\Users\UserName\Downloads\CVPowershellSDK>.\Install-CVModules.ps1 -Scope CurrentUser -Offline -PersistModulePath
• The 'PersistModulePath' switch will update the current user $env:PSModulePath environment variable to persist access to the Commvault modules across PowerShell sessions.

Usage

Login to Commcell:

• PS > Connect-CVServer

To use AccessToken to connect to the Commcell

• PS > Connect-CVServerWithAccessToken

• For information on any Commvault PowerShell command, run Get-Help [command]
• For detailed examples on any Commvault PowerShell command, run Get-Help [command] -Examples

Sample Package Function Table

Available from SP30

• Function: Connect-CVServerWithAccessToken in Module: Commvault.RESTSession

Available From V11 SP20:

• Function: Get-CVBlackoutWindow in Module: Commvault.Policies
• Function: Set-CVBlackoutWindow in Module: Commvault.Policies
• Function: Enable-CVBlackoutWindowIgnoreHigherLevelRules in Module: Commvault.Policies
• Function: Disable-CVBlackoutWindowIgnoreHigherLevelRules in Module: Commvault.Policies
• Function: Add-CVBlackoutWindow in Module: Commvault.Policies
• Function: Remove-CVBlackoutWindow in Module: Commvault.Policies
• Function: Update-CVSubclient in Module: Commvault.Commcell Available From V11 SP16:
• Function: Get-CVClient in Module: Commvault.CommCell
• Function: Get-CVClientGroup in Module: Commvault.CommCell
• Function: Get-CVVersionInfo in Module: Commvault.CommCell
• Function: Get-CVAlert in Module: Commvault.CommCell
• Function: Get-CVSubclient in Module: Commvault.CommCell
• Function: Get-CVId in Module: Commvault.CommCell
• Function: Set-CVClient in Module: Commvault.CommCell
• Function: Set-CVClientGroup in Module: Commvault.CommCell
• Function: Backup-CVClientFileSystem in Module: Commvault.FileSystem
• Function: Restore-CVClientFileSystem in Module: Commvault.FileSystem
• Function: Select-CVClientFileSystem in Module: Commvault.FileSystem
• Function: Search-CVClientFileSystem in Module: Commvault.FileSystem
• Function: Get-CVSLAReport in Module: Commvault.JobManager
• Function: Get-CVJobDetail in Module: Commvault.JobManager
• Function: Stop-CVJob in Module: Commvault.JobManager
• Function: Suspend-CVJob in Module: Commvault.JobManager
• Function: Send-CVLogFile in Module: Commvault.JobManager
• Function: Update-CVMissedSLA in Module: Commvault.JobManager
• Function: Resume-CVJob in Module: Commvault.JobManager
• Function: Get-CVJob in Module: Commvault.JobManager
• Function: Backup-CVDisasterRecovery in Module: Commvault.JobManager
• Function: Backup-CVSubclient in Module: Commvault.JobManager
• Function: Get-CVStoragePolicy in Module: Commvault.Policies
• Function: Enable-CVSchedulePolicy in Module: Commvault.Policies
• Function: Get-CVSchedulePolicy in Module: Commvault.Policies
• Function: Disable-CVSchedulePolicy in Module: Commvault.Policies
• Function: Connect-CVServer in Module: Commvault.RESTSession
• Function: Disconnect-CVServer in Module: Commvault.RESTSession
• Function: Submit-CVRESTRequest in Module: Commvault.RESTSession
• Function: Get-CVRESTHeader in Module: Commvault.RESTSession
• Function: Get-CVCommCellGlobals in Module: Commvault.RESTSession
• Function: Get-CVSessionDetail in Module: Commvault.RESTSession
• Function: Backup-CVSQLDatabase in Module: Commvault.SQLServer
• Function: Restore-CVSQLDatabase in Module: Commvault.SQLServer
• Function: Backup-CVSQLInstance in Module: Commvault.SQLServer
• Function: Mount-CVSQLDatabase in Module: Commvault.SQLServer
• Function: Get-CVSQLCloneDetail in Module: Commvault.SQLServer
• Function: Backup-CVSQLSubclient in Module: Commvault.SQLServer
• Function: Export-CVSQLDatabaseRTD in Module: Commvault.SQLServer
• Function: Get-CVSQLDatabase in Module: Commvault.SQLServer
• Function: Get-CVSQLClientDetail in Module: Commvault.SQLServer
• Function: Get-CVSQLClone in Module: Commvault.SQLServer
• Function: Get-CVSQLDatabaseBackupHistory in Module: Commvault.SQLServer
• Function: Get-CVSQLInstanceBackupHistory in Module: Commvault.SQLServer
• Function: Get-CVSQLInstanceDetail in Module: Commvault.SQLServer
• Function: Get-CVSQLDatabaseDetail in Module: Commvault.SQLServer
• Function: Get-CVSQLInstance in Module: Commvault.SQLServer
• Function: Get-CVDiskSpace in Module: Commvault.StorageResources
• Function: Get-CVSubclientMediaAgent in Module: Commvault.StorageResources
• Function: Get-CVLibrary in Module: Commvault.StorageResources
• Function: Get-CVMediaAgent in Module: Commvault.StorageResources
• Function: Get-CVVirtualMachine in Module: Commvault.VirtualServer
• Function: Add-CVVirtualMachine in Module: Commvault.VirtualServer
• Function: Add-CVVirtualMachineGroupContent in Module: Commvault.VirtualServer
• Function: Dismount-CVVirtualMachine in Module: Commvault.VirtualServer
• Function: Restore-CVVirtualMachine in Module: Commvault.VirtualServer
• Function: Mount-CVVirtualMachine in Module: Commvault.VirtualServer
• Function: Remove-CVVirtualMachine in Module: Commvault.VirtualServer
• Function: Get-CVVirtualMachineLiveMount in Module: Commvault.VirtualServer
• Function: Backup-CVVirtualMachine in Module: Commvault.VirtualServer
• Function: Get-CVVirtualMachineBackupTime in Module: Commvault.VirtualServer
• Function: Get-CVWorkflow in Module: Commvault.Workflow
• Function: Start-CVWorkflow in Module: Commvault.Workflow

Uninstallation

If the Commvault PowerShell modules were installed with the AllUsers scope:

• Launch a PowerShell session with Administrator privileges and execute: PS C:\Users\UserName\Downloads\CVPowershellSDK> .\Uninstall-CVModules.ps1

If the Commvault PowerShell modules were installed with the CurrentUser scope:

• Launch a PowerShell session with current user privileges and execute: PS C:\Users\UserName\Downloads\CVPowershellSDK> .\Uninstall-CVModules.ps1

Contributions

Contributions are welcome; please do a pull request against the 'dev' branch.

---

New Module: CVPowershellSDKV2

We have introduced a new Powershell SDK called Powershell SDK V2. You can use the Commvault PowerShell module to interact with objects in your CommCell environment using PowerShell cmdlets. The cmdlets allow you to perform much more tasks allowed in command center.

New module also includes the above commandlets from CVPowershellSDK

GitHub Link: Commvault/CVPowershellSDKV2

Installing powershell SDK from Powershell Gallery

The new SDK is published on the PowerShell Gallery.

Launch a PowerShell session and execute the following command:

Install-Module -Name CommvaultPowerShell

After installation, verify the cmdlets by running:

Get-Command –Module CommvaultPowerShell

For more information on a cmdlet, execute:

Get-Help –Name <cmdlet name>

Please visit the GitHub Commvault/CVPowershellSDKV2 for more details.

Questions/Comments/Suggestions
--------------
If you have any questions or comments, please contact us [here](https://ma.commvault.com/).
Also Check out our community for [Automation](https://community.commvault.com/developer-tools-integration-and-automation-workflow-rest-powershell-etc-50) incase of queries.