ZertoApiWrapper

1.4.0.20200410

Windows PowerShell and PowerShell Core API Wrapper Module for Zerto Virtual Manager

Minimum PowerShell version

5.1.0

Installation Options

Copy and Paste the following command to install this package using PowerShellGet More Info

Install-Module -Name ZertoApiWrapper -RequiredVersion 1.4.0.20200410

Copy and Paste the following command to install this package using Microsoft.PowerShell.PSResourceGet More Info

Install-PSResource -Name ZertoApiWrapper -Version 1.4.0.20200410

You can deploy this package directly to Azure Automation. Note that deploying packages with dependencies will deploy all the dependencies to Azure Automation. Learn More

Manually download the .nupkg file to your system's default download location. Note that the file won't be unpacked, and won't include any dependencies. Learn More

Owners

Copyright

(c) 2020 Wes Carroll. All rights reserved.

Package Details

Author(s)

  • Wes Carroll

Tags

Zerto Automation

Functions

Add-ZertoPeerSite Checkpoint-ZertoVpg Connect-ZertoAnalytics Connect-ZertoServer Copy-ZertoVpg Disconnect-ZertoServer Edit-ZertoVra Export-ZertoVmNicSetting Export-ZertoVpg Get-ZAAlert Get-ZADatastore Get-ZAEvent Get-ZAJournalAverageHistory Get-ZAJournalAverageSize Get-ZAJournalBreach Get-ZAJournalHistoryStat Get-ZAJournalSiteAverageHistory Get-ZAJournalSiteAverageSize Get-ZAJournalSiteHistoryStat Get-ZAJournalSiteHistorySummary Get-ZAJournalSiteSizeStat Get-ZAJournalStatusProportion Get-ZAJournalStorageStat Get-ZAJournalSummary Get-ZALicense Get-ZAMonitoring Get-ZANetworkSiteAverageIOPS Get-ZANetworkSiteAveragePerformance Get-ZANetworkSiteStat Get-ZANetworkSiteSummary Get-ZANetworkVpgAverageIOPS Get-ZANetworkVpgAveragePerformance Get-ZANetworkVpgStat Get-ZANetworkVpgSummary Get-ZAPlannerJournalSizeReport Get-ZAPlannerNetworkPerformanceReport Get-ZAPlannerSite Get-ZAPlannerStatsReport Get-ZAPlannerWanReport Get-ZAPlannerZcasReport Get-ZAProtectedVm Get-ZAProtectedVmReport Get-ZARPOAccountAverage Get-ZARPOAverage Get-ZARPOBreach Get-ZARPOStat Get-ZARPOStatusProportion Get-ZARPOSummary Get-ZASite Get-ZASitePair Get-ZASiteTopology Get-ZATask Get-ZAVolume Get-ZAVpg Get-ZAzOrg Get-ZertoAlert Get-ZertoDatastore Get-ZertoEvent Get-ZertoLicense Get-ZertoLocalSite Get-ZertoPeerSite Get-ZertoProtectedVm Get-ZertoRecoveryReport Get-ZertoResourcesReport Get-ZertoServiceProfile Get-ZertoTask Get-ZertoUnprotectedVm Get-ZertoVirtualizationSite Get-ZertoVolume Get-ZertoVpg Get-ZertoVpgSetting Get-ZertoVra Get-ZertoZorg Get-ZertoZsspSession Import-ZertoVmNicSetting Import-ZertoVpg Install-ZertoVra Invoke-ZARestRequest Invoke-ZertoEvacuateVra Invoke-ZertoFailover Invoke-ZertoFailoverCommit Invoke-ZertoFailoverRollback Invoke-ZertoForceSync Invoke-ZertoMove Invoke-ZertoMoveCommit Invoke-ZertoMoveRollback Invoke-ZertoRestRequest New-ZertoPairingToken New-ZertoVpg New-ZertoVpgSettingsIdentifier Remove-ZertoPeerSite Remove-ZertoVpg Remove-ZertoVpgSettingsIdentifier Resume-ZertoVpg Save-ZertoVpgSetting Set-ZertoAlert Set-ZertoLicense Set-ZertoUserCredential Start-ZertoCloneVpg Start-ZertoFailoverTest Stop-ZertoCloneVpg Stop-ZertoFailoverTest Suspend-ZertoVpg Uninstall-ZertoVra

Dependencies

This module has no dependencies.

Release Notes

# 1.4.0.20200410

### Zerto Virtual Manager

* Addressed a reported [issue](https://github.com/ZertoPublic/ZertoApiWrapper/issues/60) in the `Get-ZertoRecoveryReport` function where the `-VpgIdentifier` parameter was not working. This parameter is not accepted by the API as a valid filter and is ignored. This parameter has been removed from the function.
* Addressed a reported [issue](https://github.com/ZertoPublic/ZertoApiWrapper/issues/61) where the `Export-ZertoVpgNicSetting` function would not properly execute when run against a VM with no NICs attached.
* In reviewing the `Export-ZertoVpgNicSetting`, a review of the `Import-ZertoVpgNicSetting` was completed and it was determined to update the import logic based on various test cases. Along with this, it is now possible to reset the NIC settings to the default state with the `Import-ZertoVpgNicSetting` command. Please review the [Import-ZertoVpgNicSetting help](https://github.com/ZertoPublic/ZertoApiWrapper/blob/master/docs/Import-ZertoVmNicSetting.md) to review the updated options and import logic.
* Refactored the `Checkpoint-ZertoVpg` command to allow pipeline input (ByValue and ByProperty) for the VpgName parameter.
* Corrected a parameter typo in the `Get-ZertoVpgSetting` function. The misspelt parameter was added as an alias to ensure any existing scripts using the parameter continue to function.
* Refactored the `Get-ZertoVpg` command to remove repetitive commands and variables that are no longer required.
* Moved `Invoke-ZertoRestRequest` and `Invoke-ZARestRequest` to be public functions. As there become more and more scenarios where there are not prebuilt functions to accomplish complex specialized tasks, it became apparent that these functions could be leveraged to make the experience and workflow easier.
* Updated the `Install-ZertoVra` logic to ensure that the target datastore is available on the target host. There isn't currently any method to validate the target network, but if that becomes available in a later version of the API, the function will be updated.
* Updated the `Install-ZertoVra` function to allow for installation of the VRA using the host password method. Please review the [Install-ZertoVra](https://github.com/ZertoPublic/ZertoApiWrapper/blob/master/docs/Install-ZertoVra.md) documentation for syntax and examples.
* Updated the `Edit-ZertoVra` function to allow for modification of the associated ESX host password if the need arises. Please review the [Edit-ZertoVra](https://github.com/ZertoPublic/ZertoApiWrapper/blob/master/docs/Edit-ZertoVra.md) documentation for syntax and examples.
* Added a new function, `Set-ZertoUserCredential`, to allow the updating of the username and password used to connect the Zerto Virtual Manager to the paired hypervisor. Please see the [Set-ZertoUserCredential](https://github.com/ZertoPublic/ZertoApiWrapper/blob/master/docs/Set-ZertoUserCredential.md) help for additional information.
* With the release of [Zerto 8.0](https://www.zerto.com/zerto-8-0-general-availability/) some additional API endpoints have become available.
 * Updated `Get-ZertoVirtualizationSite` to add the `-repository` parameter to enable returning information for LTR repositories.
 * Updated `Get-ZertoVpgSetting` to add the `-ltr` parameter to enable returning information for current LTR settings for the selected VPG.

###  Zerto Analytics

* Added several functions for the newly added [Zerto Analytics](https://analytics.zerto.com/) Planner.
 * `Get-ZAPlannerSite` Help can be found here: [Get-ZAPlannerSite](https://github.com/ZertoPublic/ZertoApiWrapper/blob/master/docs/Get-ZAPlannerSite.md)
 * `Get-ZAPlannerStatsReport` Help can be found here: [Get-ZAPlannerStatsReport](https://github.com/ZertoPublic/ZertoApiWrapper/blob/master/docs/Get-ZAPlannerStatsReport.md)
 * `Get-ZAPlannerJournalSizeReport` Help can be found here: [Get-ZAPlannerJournalSizeReport](https://github.com/ZertoPublic/ZertoApiWrapper/blob/master/docs/Get-ZAPlannerJournalSizeReport.md)
 * `Get-ZAPlannerNetworkPerformanceReport` Help can be found here: [Get-ZAPlannerNetworkPerformanceReport](https://github.com/ZertoPublic/ZertoApiWrapper/blob/master/docs/Get-ZAPlannerNetworkPerformanceReport.md)
 * `Get-ZAPlannerWanReport` Help can be found here: [Get-ZAPlannerWanReport](https://github.com/ZertoPublic/ZertoApiWrapper/blob/master/docs/Get-ZAPlannerWanReport.md)
 * `Get-ZAPlannerZcasReport` Help can be found here: [Get-ZAPlannerZcasReport](https://github.com/ZertoPublic/ZertoApiWrapper/blob/master/docs/Get-ZAPlannerZcasReport.md)
* Created `Get-ZAProtectedVm` and `Get-ZAProtectedVmReport` functions to leverage the newly released Zerto Analytics APIs for this data. Help files can be found here: [Get-ZAProtectedVm](https://github.com/ZertoPublic/ZertoApiWrapper/blob/master/docs/Get-ZAProtectedVm.md) and [Get-ZAProtectedVmReport](https://github.com/ZertoPublic/ZertoApiWrapper/blob/master/docs/Get-ZAProtectedVmReport.md)

FileList

Version History

Version Downloads Last updated
2.0.0 147 1/24/2024
1.5.4 5,097 2/26/2022
1.5.3 1,978 12/16/2020
1.5.2 84 10/19/2020
1.5.1 32 9/8/2020
1.5.0 69 8/20/2020
1.4.3 87 7/8/2020
1.4.2 131 5/17/2020
1.4.1 41 5/6/2020
1.4.0.20200410 (current version) 124 4/10/2020
1.3.0.20191201 192 12/1/2019
1.2.0.20190801 166 8/1/2019
1.1.0.34 97 6/17/2019
Show less