From 4f9f5e26ae60655a42dfd1e24ba7f7f6db0c9742 Mon Sep 17 00:00:00 2001 From: Wes Carroll Date: Mon, 11 Mar 2019 20:38:51 -0400 Subject: [PATCH] Add help information for default journal settings --- .../Public/en-us/ZertoApiWrapper-help.xml | 254 +++++++++++++++++- docs/New-ZertoVpg.md | 55 +++- 2 files changed, 307 insertions(+), 2 deletions(-) diff --git a/ZertoApiWrapper/Public/en-us/ZertoApiWrapper-help.xml b/ZertoApiWrapper/Public/en-us/ZertoApiWrapper-help.xml index b2cf3fb..64a1bf9 100644 --- a/ZertoApiWrapper/Public/en-us/ZertoApiWrapper-help.xml +++ b/ZertoApiWrapper/Public/en-us/ZertoApiWrapper-help.xml @@ -7894,6 +7894,30 @@ None + + journalDatastore + + Name of the datastore to utilize to store Journal data. If not specified, the default datastore will be used. + + String + + String + + + None + + + journalHardLimitInMb + + Default journal hard limit in megabytes. Default set to 153600 MB (150 GB). Set to 0 to set the journal to unlimited + + Int32 + + Int32 + + + 153600 + journalHistoryInHours @@ -7906,6 +7930,18 @@ 24 + + journalWarningThresholdInMb + + Default journal warning threshold in megabytes. If unset or greater than the hard limit, will be set to 75% of the journal hard limit. If the journalHardLimitInMB is set to 0 (unlimited), this will be set to unlimited as well. + + Int32 + + Int32 + + + None + protectedVm @@ -8090,6 +8126,30 @@ None + + journalDatastore + + Name of the datastore to utilize to store Journal data. If not specified, the default datastore will be used. + + String + + String + + + None + + + journalHardLimitInMb + + Default journal hard limit in megabytes. Default set to 153600 MB (150 GB). Set to 0 to set the journal to unlimited + + Int32 + + Int32 + + + 153600 + journalHistoryInHours @@ -8102,6 +8162,18 @@ 24 + + journalWarningThresholdInMb + + Default journal warning threshold in megabytes. If unset or greater than the hard limit, will be set to 75% of the journal hard limit. If the journalHardLimitInMB is set to 0 (unlimited), this will be set to unlimited as well. + + Int32 + + Int32 + + + None + protectedVm @@ -8286,6 +8358,30 @@ None + + journalDatastore + + Name of the datastore to utilize to store Journal data. If not specified, the default datastore will be used. + + String + + String + + + None + + + journalHardLimitInMb + + Default journal hard limit in megabytes. Default set to 153600 MB (150 GB). Set to 0 to set the journal to unlimited + + Int32 + + Int32 + + + 153600 + journalHistoryInHours @@ -8298,6 +8394,18 @@ 24 + + journalWarningThresholdInMb + + Default journal warning threshold in megabytes. If unset or greater than the hard limit, will be set to 75% of the journal hard limit. If the journalHardLimitInMB is set to 0 (unlimited), this will be set to unlimited as well. + + Int32 + + Int32 + + + None + protectedVm @@ -8482,6 +8590,30 @@ None + + journalDatastore + + Name of the datastore to utilize to store Journal data. If not specified, the default datastore will be used. + + String + + String + + + None + + + journalHardLimitInMb + + Default journal hard limit in megabytes. Default set to 153600 MB (150 GB). Set to 0 to set the journal to unlimited + + Int32 + + Int32 + + + 153600 + journalHistoryInHours @@ -8494,6 +8626,18 @@ 24 + + journalWarningThresholdInMb + + Default journal warning threshold in megabytes. If unset or greater than the hard limit, will be set to 75% of the journal hard limit. If the journalHardLimitInMB is set to 0 (unlimited), this will be set to unlimited as well. + + Int32 + + Int32 + + + None + protectedVm @@ -8678,6 +8822,30 @@ None + + journalDatastore + + Name of the datastore to utilize to store Journal data. If not specified, the default datastore will be used. + + String + + String + + + None + + + journalHardLimitInMb + + Default journal hard limit in megabytes. Default set to 153600 MB (150 GB). Set to 0 to set the journal to unlimited + + Int32 + + Int32 + + + 153600 + journalHistoryInHours @@ -8690,6 +8858,18 @@ 24 + + journalWarningThresholdInMb + + Default journal warning threshold in megabytes. If unset or greater than the hard limit, will be set to 75% of the journal hard limit. If the journalHardLimitInMB is set to 0 (unlimited), this will be set to unlimited as well. + + Int32 + + Int32 + + + None + protectedVm @@ -8874,6 +9054,30 @@ None + + journalDatastore + + Name of the datastore to utilize to store Journal data. If not specified, the default datastore will be used. + + String + + String + + + None + + + journalHardLimitInMb + + Default journal hard limit in megabytes. Default set to 153600 MB (150 GB). Set to 0 to set the journal to unlimited + + Int32 + + Int32 + + + 153600 + journalHistoryInHours @@ -8886,6 +9090,18 @@ 24 + + journalWarningThresholdInMb + + Default journal warning threshold in megabytes. If unset or greater than the hard limit, will be set to 75% of the journal hard limit. If the journalHardLimitInMB is set to 0 (unlimited), this will be set to unlimited as well. + + Int32 + + Int32 + + + None + protectedVm @@ -9082,6 +9298,30 @@ None + + journalDatastore + + Name of the datastore to utilize to store Journal data. If not specified, the default datastore will be used. + + String + + String + + + None + + + journalHardLimitInMb + + Default journal hard limit in megabytes. Default set to 153600 MB (150 GB). Set to 0 to set the journal to unlimited + + Int32 + + Int32 + + + 153600 + journalHistoryInHours @@ -9094,6 +9334,18 @@ 24 + + journalWarningThresholdInMb + + Default journal warning threshold in megabytes. If unset or greater than the hard limit, will be set to 75% of the journal hard limit. If the journalHardLimitInMB is set to 0 (unlimited), this will be set to unlimited as well. + + Int32 + + Int32 + + + None + protectedVm @@ -9372,7 +9624,7 @@ - -------------------------- Example 5 -------------------------- + -------------------------- Example 6 -------------------------- PS C:> New-ZertoVpg -vpgName "MyVpg" -protectedVm "WebServer01", "AppServer01", "DatabaseServer01" -recoverySite "Recovery Site" -recoveryFolder "Recovered VMs" -recoveryResourcePool "Recovery Resource Pool Name" -recoveryDatastoreCluster "Datastore Cluster Name" -testNetwork "Test Bubble Network" -recoveryNetwork "VM Network" Creates a VPG Settings Object for a VPG called "MyVpg" and protecting Virtual Machines "WebServer01", "AppServer01", and "DatabaseServer01" targeting site "Recovery Site." The Virtual machines will be placed on the resource pool "Recovery Resource Pool Name" on the datastore cluster named "Datastore Cluster Name." When the virtual machines are created at the recovery site, they will be created in the folder "Recovered VMs." Finally, the network to be used during a live event will be "VM Network" and during a test operation will be "VM Network." Other values set will be the defaults, such as: diff --git a/docs/New-ZertoVpg.md b/docs/New-ZertoVpg.md index 1ceb1fb..46aea84 100644 --- a/docs/New-ZertoVpg.md +++ b/docs/New-ZertoVpg.md @@ -18,6 +18,7 @@ New-ZertoVpg -vpgName [-vpgPriority ] [-journalHistoryInHours < -recoverySite -recoveryCluster -datastoreCluster -recoveryFolder [-rpoInSeconds ] [-testIntervalInMinutes ] [-serviceProfile ] [-useWanCompression ] [-zorg ] -recoveryNetwork -testNetwork + [-journalDatastore ] [-journalHardLimitInMb ] [-journalWarningThresholdInMb ] [] ``` @@ -27,6 +28,7 @@ New-ZertoVpg -vpgName [-vpgPriority ] [-journalHistoryInHours < -recoverySite -recoveryCluster -datastore -recoveryFolder [-rpoInSeconds ] [-testIntervalInMinutes ] [-serviceProfile ] [-useWanCompression ] [-zorg ] -recoveryNetwork -testNetwork + [-journalDatastore ] [-journalHardLimitInMb ] [-journalWarningThresholdInMb ] [] ``` @@ -36,6 +38,7 @@ New-ZertoVpg -vpgName [-vpgPriority ] [-journalHistoryInHours < -recoverySite -recoveryHost -datastoreCluster -recoveryFolder [-rpoInSeconds ] [-testIntervalInMinutes ] [-serviceProfile ] [-useWanCompression ] [-zorg ] -recoveryNetwork -testNetwork + [-journalDatastore ] [-journalHardLimitInMb ] [-journalWarningThresholdInMb ] [] ``` @@ -45,6 +48,7 @@ New-ZertoVpg -vpgName [-vpgPriority ] [-journalHistoryInHours < -recoverySite -recoveryHost -datastore -recoveryFolder [-rpoInSeconds ] [-testIntervalInMinutes ] [-serviceProfile ] [-useWanCompression ] [-zorg ] -recoveryNetwork -testNetwork + [-journalDatastore ] [-journalHardLimitInMb ] [-journalWarningThresholdInMb ] [] ``` @@ -54,6 +58,7 @@ New-ZertoVpg -vpgName [-vpgPriority ] [-journalHistoryInHours < -recoverySite -recoveryResourcePool -datastoreCluster -recoveryFolder [-rpoInSeconds ] [-testIntervalInMinutes ] [-serviceProfile ] [-useWanCompression ] [-zorg ] -recoveryNetwork -testNetwork + [-journalDatastore ] [-journalHardLimitInMb ] [-journalWarningThresholdInMb ] [] ``` @@ -63,6 +68,7 @@ New-ZertoVpg -vpgName [-vpgPriority ] [-journalHistoryInHours < -recoverySite -recoveryResourcePool -datastore -recoveryFolder [-rpoInSeconds ] [-testIntervalInMinutes ] [-serviceProfile ] [-useWanCompression ] [-zorg ] -recoveryNetwork -testNetwork + [-journalDatastore ] [-journalHardLimitInMb ] [-journalWarningThresholdInMb ] [] ``` @@ -148,7 +154,7 @@ Creates a VPG Settings Object for a VPG called "MyVpg" and protecting Virtual Ma - ServiceProfile: Null - Zorg: Null -### Example 5 +### Example 6 ```powershell PS C:> New-ZertoVpg -vpgName "MyVpg" -protectedVm "WebServer01", "AppServer01", "DatabaseServer01" -recoverySite "Recovery Site" -recoveryFolder "Recovered VMs" -recoveryResourcePool "Recovery Resource Pool Name" -recoveryDatastoreCluster "Datastore Cluster Name" -testNetwork "Test Bubble Network" -recoveryNetwork "VM Network" ``` @@ -195,6 +201,36 @@ Accept pipeline input: False Accept wildcard characters: False ``` +### -journalDatastore +Name of the datastore to utilize to store Journal data. If not specified, the default datastore will be used. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -journalHardLimitInMb +Default journal hard limit in megabytes. Default set to 153600 MB (150 GB). Set to 0 to set the journal to unlimited + +```yaml +Type: Int32 +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: 153600 +Accept pipeline input: False +Accept wildcard characters: False +``` + ### -journalHistoryInHours Journal History in Hours. Min 1 hour, Max 720 Hours (30 days) @@ -211,6 +247,21 @@ Accept pipeline input: False Accept wildcard characters: False ``` +### -journalWarningThresholdInMb +Default journal warning threshold in megabytes. If unset or greater than the hard limit, will be set to 75% of the journal hard limit. If the journalHardLimitInMB is set to 0 (unlimited), this will be set to unlimited as well. + +```yaml +Type: Int32 +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + ### -protectedVm Name(s) of the VM(s) to be protected. @@ -451,7 +502,9 @@ This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable ### System.String Vpg Settings Identifier + ## NOTES ## RELATED LINKS + [Zerto REST API VPG Settings End Point Documentation](http://s3.amazonaws.com/zertodownload_docs/Latest/Zerto%20Virtual%20Replication%20Zerto%20Virtual%20Manager%20%28ZVM%29%20-%20vSphere%20Online%20Help/RestfulAPIs/StatusAPIs.5.108.html#) \ No newline at end of file