Add the Sync-Beneficiary cmdlet

Author: CedX

ChangeLog.md

@@ -1,7 +1,7 @@
 # Changelog
 
 ## Version [0.5.0](https://github.com/MC2IT/Agicap.ps1/compare/v0.4.0...v0.5.0)
-- **Payments:** added the `New-SynchronizedBeneficiary` cmdlets.
+- **Payments:** added the `New-SynchronizedBeneficiary`, `Sync-Beneficiary` cmdlets.
 
 ## Version [0.4.0](https://github.com/MC2IT/Agicap.ps1/compare/v0.3.0...v0.4.0)
 - Added the `-Scope` parameter to the `New-Client` cmdlet.

Sources/Payments/Sync-Beneficiary.ps1

@@ -0,0 +1,31 @@
+using namespace Mc2it.Agicap
+using namespace System.Net.Http
+
+<#
+.SYNOPSIS
+	Starts a bulk synchronization of beneficiaries from the ERP software.
+.OUTPUTS
+	The identifier of the newly started synchronization.
+#>
+function Sync-Beneficiary {
+	[CmdletBinding()]
+	[OutputType([guid])]
+	param (
+		# The API client.
+		[Parameter(Mandatory, Position = 1)]
+		[Client] $Client,
+
+		# The beneficiaries to synchronize.
+		[Parameter(Mandatory, Position = 2)]
+		[SynchronizedBeneficiary[]] $Beneficiaries
+	)
+
+	begin {
+		$api = $Client.Payments.Beneficiaries($EntityId).Synchronization
+	}
+
+	process {
+		try { $api.Create($Beneficiaries) }
+		catch [HttpRequestException] { Write-Error $_ }
+	}
+}