From f3d07003b4afb3a924d69ee977126e24ae1763c6 Mon Sep 17 00:00:00 2001
From: Wes Carroll <wcarroll@oceanbeachlife.com>
Date: Sun, 9 Jun 2019 11:17:07 -0400
Subject: [PATCH] Create Get-ZARPOAccountAverage and Docs

---
 .../Public/Get-ZARPOAccountAverage.Tests.ps1  |  19 +++
 .../Public/Get-ZARPOAccountAverage.ps1        |  25 ++++
 docs/Get-ZARPOAccountAverage.md               | 109 ++++++++++++++++++
 3 files changed, 153 insertions(+)
 create mode 100644 Tests/Public/Get-ZARPOAccountAverage.Tests.ps1
 create mode 100644 ZertoApiWrapper/Public/Get-ZARPOAccountAverage.ps1
 create mode 100644 docs/Get-ZARPOAccountAverage.md

diff --git a/Tests/Public/Get-ZARPOAccountAverage.Tests.ps1 b/Tests/Public/Get-ZARPOAccountAverage.Tests.ps1
new file mode 100644
index 0000000..f5816b6
--- /dev/null
+++ b/Tests/Public/Get-ZARPOAccountAverage.Tests.ps1
@@ -0,0 +1,19 @@
+#Requires -Modules Pester
+$moduleFileName = "ZertoApiWrapper.psd1"
+$here = (Split-Path -Parent $MyInvocation.MyCommand.Path).Replace("Tests", "ZertoApiWrapper")
+$sut = (Split-Path -Leaf $MyInvocation.MyCommand.Path).Replace(".Tests.", ".")
+$file = Get-ChildItem "$here\$sut"
+$modulePath = $here -replace "Public", ""
+$moduleFile = Get-ChildItem "$modulePath\$moduleFileName"
+Get-Module -Name ZertoApiWrapper | Remove-Module -Force
+Import-Module $moduleFile -Force
+
+Describe $file.BaseName -Tag 'Unit' {
+
+    It "is valid Powershell (Has no script errors)" {
+        $contents = Get-Content -Path $file -ErrorAction Stop
+        $errors = $null
+        $null = [System.Management.Automation.PSParser]::Tokenize($contents, [ref]$errors)
+        $errors | Should -HaveCount 0
+    }
+}
diff --git a/ZertoApiWrapper/Public/Get-ZARPOAccountAverage.ps1 b/ZertoApiWrapper/Public/Get-ZARPOAccountAverage.ps1
new file mode 100644
index 0000000..d9149fc
--- /dev/null
+++ b/ZertoApiWrapper/Public/Get-ZARPOAccountAverage.ps1
@@ -0,0 +1,25 @@
+<# .ExternalHelp ./en-us/ZertoApiWrapper-help.xml #>
+function Get-ZARPOAccountAverage {
+    [CmdletBinding()]
+    param (
+        [Parameter(
+            Helpmessage = "The ZORG identifier by which to filter the user's average RPO for a single account. If the ZORG identifier is omitted, statistics related to all sites, for a single account, is retrieved."
+        )]
+        [ValidateNotNullOrEmpty()]
+        [string]$zOrgIdentifier,
+        [Parameter(
+            HelpMessage = "The starting date of the report, in RFC 3339 standard ('1970-01-01T00:00:00Z'). If only the end date is added, the start date by default will be the end date minus 7 days."
+        )]
+        [ValidateNotNullOrEmpty()]
+        [string]$startDate,
+        [Parameter(
+            HelpMessage = "The end date of the report, in RFC 3339 standard ('1970-01-01T00:00:00Z'). The default is the current time."
+        )]
+        [ValidateNotNullOrEmpty()]
+        [string]$endDate
+    )
+
+    $filter = Get-ZertoApiFilter -FilterTable $PSBoundParameters
+    $uri = "reports/account-rpo-average{0}" -f $filter
+    Invoke-ZARestRequest -uri $uri
+}
diff --git a/docs/Get-ZARPOAccountAverage.md b/docs/Get-ZARPOAccountAverage.md
new file mode 100644
index 0000000..d5eded0
--- /dev/null
+++ b/docs/Get-ZARPOAccountAverage.md
@@ -0,0 +1,109 @@
+---
+external help file: ZertoApiWrapper-help.xml
+Module Name: ZertoApiWrapper
+online version: https://github.com/ZertoPublic/ZertoApiWrapper/blob/Master/docs/Get-ZARPOAccountAverage.md
+schema: 2.0.0
+---
+
+# Get-ZARPOAccountAverage
+
+## SYNOPSIS
+
+Get average RPO for all VPGs in a single account, filtered by last 30 days.
+
+## SYNTAX
+
+```
+Get-RPOAccountAverage [[-zOrgIdentifier] <String>] [[-startDate] <String>] [[-endDate] <String>]
+ [<CommonParameters>]
+```
+
+## DESCRIPTION
+
+Get average RPO for all VPGs in a single account, filtered by last 30 days.
+
+## EXAMPLES
+
+### Example 1
+```powershell
+PS C:\> Get-ZARPOAccountAverage
+```
+
+Get average RPO for all VPGs in a single account.
+
+### Example 2
+```powershell
+PS C:\> Get-ZARPOAccountAverage -zOrgIdentifier "1234-5678-9012"
+```
+
+Get average RPO for all VPGs in zOrg with identifier "1234-5678-9012".
+
+### Example 3
+```powershell
+PS C:\> Get-ZARPOAccountAverage -startDate "2019-06-01T00:00:00Z" -endDate "2019-06-02T00:00:00Z"
+```
+
+Get average RPO for all VPGs in a single account for June 6th, 2019
+
+## PARAMETERS
+
+### -endDate
+The end date of the report, in RFC 3339 standard ('1970-01-01T00:00:00Z').
+The default is the current time.
+
+```yaml
+Type: String
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: 3
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -startDate
+The starting date of the report, in RFC 3339 standard ('1970-01-01T00:00:00Z').
+If only the end date is added, the start date by default will be the end date minus 7 days.
+
+```yaml
+Type: String
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: 2
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -zOrgIdentifier
+The ZORG identifier by which to filter the user's average RPO for a single account.
+If the ZORG identifier is omitted, statistics related to all sites, for a single account, is retrieved.
+
+```yaml
+Type: String
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: 1
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### CommonParameters
+This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216).
+
+## INPUTS
+
+## OUTPUTS
+
+## NOTES
+
+## RELATED LINKS
+
+[Zerto Analytics REST API Endpoint for RPO Average](https://docs.api.zerto.com/#/RPO_Reports/get_v2_reports_account_rpo_average)