[Feature Request] Create a PS module for using SRS

[vmware]

[Feature Request] Create a PS module for using SRS

[dmilov]

Good one. We can create an SRS Client PS Module and update the API pester tests to use it. I'll prepare the scaffold, feel free to put all the content there.

[dmilov]

Added the module manifest

https://github.com/vmware/script-runtime-service-for-vsphere/tree/master/client-sdk/powershell

@lucdekens Feel free to add content in there.
https://github.com/vmware/script-runtime-service-for-vsphere/blob/master/test/api-integration-tests/tests/SRSAPIHelpers.ps1 could help.

[dmilov]

Let's start with PS 7 initially, later we can add support for 5.1

[lucdekens]

Thanks for the pointer to SRSAPIHelpers.ps1.

Question: shall the module support PSv5.1?

If yes, we have to foresee an alternative for the SkipCertificateCheck switch when invoked from PSv5.1.
Something similar to what I did in my Invoke-SrsMethod function in my A Hitchhikers Guide To SRS 1.0.0

[dmilov]

As a SkipCertificateCheck solution for PS 5.1 I can suggest a wrapper function like

function Invoke-RestMethodEx {
param(
# InvokeRestMethodParams,

[switch]
$SkipCertificateCheck

)

    if (-not("SkipCertificateCheck" -as [type])) {
        Add-Type -TypeDefinition `
                ("using System;" + `
                "using System.Net;" + `
                "using System.Net.Security;" + `
                "using System.Security.Cryptography.X509Certificates;" + `
                "public static class SkipCertificateCheck {" + `
                    "public static bool ReturnTrue(object sender," + `
                        "X509Certificate certificate," + `
                        "X509Chain chain," + `
                        "SslPolicyErrors sslPolicyErrors) { return true; }" + `
                    "public static RemoteCertificateValidationCallback GetDelegate() {" + `
                        "return new RemoteCertificateValidationCallback(SkipCertificateCheck.ReturnTrue);" + `
                    "}" + `
                "}")
    }

    if ($SkipCertificateCheck) {
        [System.Net.ServicePointManager]::ServerCertificateValidationCallback += [SkipCertificateCheck]::GetDelegate()
    }

    Invoke-RestMethod https://10.23.82.191/api/about

   if ($SkipCertificateCheck) {
     # back to previous value, for the sake of example I assume it was $null
       [System.Net.ServicePointManager]::ServerCertificateValidationCallback = $null
   }

}