Add cmdlets to change cli Settings of ESG

module/PowerNSX.psm1

@@ -3464,6 +3464,39 @@ Function ValidateEdgeDns {
     else {
         throw "Specify a valid Edge DNS object."
     }
+
+}
+
+function ValidateCliSettings {
+    Param (
+        [Parameter (Mandatory=$true)]
+        [object]$argument
+    )
+
+    if ($argument -is [System.Xml.XmlElement] ) {
+
+        if ( -not ( $argument | get-member -name edgeId -Membertype Properties)) {
+            throw "XML Element specified does not contain an edgeId property."
+        }
+
+        if ( -not ( $argument | get-member -name remoteAccess -Membertype Properties)) {
+            throw "XML Element specified does not contain an remoteAccess property."
+        }
+
+        if ( -not ( $argument | get-member -name sshLoginBannerText -Membertype Properties)) {
+            throw "XML Element specified does not contain an sshLoginBannerText property."
+        }
+
+        if ( -not ( $argument | get-member -name passwordExpiry -Membertype Properties)) {
+            throw "XML Element specified does not contain an passwordExpiry property."
+        }
+
+        $true
+    }
+    else {
+        throw "Specify a valid CliSettings Configuration object."
+    }
+
 }
 
 Function ValidateIPsec {
@@ -13914,6 +13947,31 @@ function Set-NsxEdge {
 
     Disable the Edge Firewall on ESG Edge01
 
+    .EXAMPLE
+    Get-NsxEdge Edge01 | Set-NsxEdge -password Vmware1!Vmware1!
+
+    Change the SSH Password
+
+    .EXAMPLE
+    Get-NsxEdge Edge01 | Set-NsxEdge -remoteAccess:$true
+
+    Enable the SSH on ESG (you can use also use Enable-NsxSSHEdgeSSH)
+
+    .EXAMPLE
+    Get-NsxEdge Edge01 | Set-NsxEdge -username powernsx -password Vmware1!Vmware1!
+
+    Set the SSH username to PowerNSX (You need to change/set the password on the sametime)
+
+    .EXAMPLE
+    Get-NsxEdge Edge01 | Set-NsxEdge -sshLoginBannerText "My Login Banner"
+
+    Change the SSH Login Banner
+
+    .EXAMPLE
+    Get-NsxEdge Edge01 | Set-NsxEdge -passwordExpiry 30
+
+    Change the SSH Password Expiration to 30 (days)
+
     #>
 
     [CmdletBinding()]
@@ -13926,6 +13984,25 @@ function Set-NsxEdge {
         [Parameter (Mandatory=$False)]
             #Prompt for confirmation.  Specify as -confirm:$false to disable confirmation prompt
             [switch]$Confirm=$true,
+
+        #cliSettings
+        [Parameter (Mandatory=$false)]
+            [ValidateNotNullorEmpty()]
+            [String]$userName,
+        [Parameter (Mandatory=$false)]
+            [ValidateNotNullorEmpty()]
+            [String]$password,
+        [Parameter (Mandatory=$false)]
+            [ValidateNotNullorEmpty()]
+            [boolean]$remoteAccess,
+        [Parameter (Mandatory=$false)]
+            [ValidateNotNullorEmpty()]
+            [ValidateRange(1,99999)]
+            [int]$passwordExpiry,
+        [Parameter (Mandatory=$false)]
+            [ValidateNotNullorEmpty()]
+            [string]$sshLoginBannerText,
+
         [Parameter (Mandatory=$False)]
             #PowerNSX Connection object
             [ValidateNotNullOrEmpty()]
@@ -13947,6 +14024,51 @@ function Set-NsxEdge {
             $_Edge.RemoveChild($edgeSummary) | out-null
         }
 
+        #cliSettings
+        if ( $PsBoundParameters.ContainsKey('userName') ) {
+            if ( $PsBoundParameters.ContainsKey('password') ) {
+                if ( invoke-xpathquery -node $_Edge -querymethod SelectSingleNode -Query "child::cliSettings/userName" ) {
+                    $_Edge.cliSettings.username = $userName
+                } else {
+                    Add-XmlElement -xmlroot $_Edge.cliSettings -xmlElementName "userName" -xmlElementText $userName
+                }
+            } else {
+                throw "You need to specify a password for change username..."
+            }
+        }
+
+        if ( $PsBoundParameters.ContainsKey('password') ) {
+            if ( invoke-xpathquery -node $_Edge -querymethod SelectSingleNode -Query "child::cliSettings/password" ) {
+                $_Edge.cliSettings.password = $password
+            } else {
+                Add-XmlElement -xmlRoot $_Edge.cliSettings -xmlElementName "password" -xmlElementText $password
+            }
+        }
+
+        if ( $PsBoundParameters.ContainsKey('remoteAccess') ) {
+            if ( invoke-xpathquery -node $_Edge -querymethod SelectSingleNode -Query "child::cliSettings/remoteAccess" ) {
+                $_Edge.cliSettings.remoteAccess = $remoteAccess.ToString().ToLower()
+            } else {
+                Add-XmlElement -xmlroot $_Edge.cliSettings -xmlElementName "remoteAccess" -xmlElementText $remoteAccess.ToString().ToLower()
+            }
+        }
+
+        if ( $PsBoundParameters.ContainsKey('passwordExpiry') ) {
+            if ( invoke-xpathquery -node $_Edge -querymethod SelectSingleNode -Query "child::cliSettings/passwordExpiry" ) {
+                $_Edge.cliSettings.passwordExpiry = $passwordExpiry
+            } else {
+                Add-XmlElement -xmlroot $_Edge.cliSettings -xmlElementName "passwordExpiry" -xmlElementText $passwordExpiry.ToString()
+            }
+        }
+
+        if ( $PsBoundParameters.ContainsKey('sshLoginBannerText') ) {
+            if ( invoke-xpathquery -node $_Edge -querymethod SelectSingleNode -Query "child::cliSettings/sshLoginBannerText" ) {
+                $_Edge.cliSettings.sshLoginBannerText = $sshLoginBannerText
+            } else {
+                Add-XmlElement -xmlroot $_Edge.cliSettings -xmlElementName "sshLoginBannerText" -xmlElementText $sshLoginBannerText
+            }
+        }
+
         $URI = "/api/4.0/edges/$($_Edge.Id)"
         $body = $_Edge.OuterXml
 

tests/integration/04.Edge.Tests.ps1

@@ -726,6 +726,51 @@ Describe "Edge" {
         }
     }
 
+    Context "CliSettings" {
+
+        it "Can retrieve cliSettings" {
+            $edge =  Get-NsxEdge $name
+            $edge.cliSettings | should not be $null
+            #By default it is admin
+            $edge.cliSettings.userName | should be "admin"
+            #By default it is 99999
+            $edge.cliSettings.passwordExpiry | should be "99999"
+        }
+
+        it "Can disable SSH" {
+            $edge = Get-NsxEdge $name
+            Get-NsxEdge $name | Set-NsxEdge -remoteAccess:$false -confirm:$false
+            $edge = Get-NsxEdge $name
+            $edge.cliSettings.remoteAccess | should be "false"
+        }
+
+        it "Can enable SSH" {
+            Get-NsxEdge $name | Set-NsxEdge -remoteAccess:$true -confirm:$false
+            $edge = Get-NsxEdge $name
+            $edge.cliSettings.remoteAccess | should be "true"
+        }
+
+        it "Change (SSH) username (and Password)" {
+            #it is mandatory to change username (and Password) on the same time (bug or feature ?)
+            Get-NsxEdge $name | Set-NsxEdge -userName powernsxviasetnsxedge -Password "Vmware1!Vmware1!" -confirm:$false
+            $edge = Get-NsxEdge $name
+            $edge.cliSettings.userName | should be "powernsxviasetnsxedge"
+            #It is impossible to check if the password is modified...
+        }
+
+        it "Change Password Expiry" {
+            Get-NsxEdge $name | Set-NsxEdge -passwordExpiry 4242 -confirm:$false
+            $edge = Get-NsxEdge $name
+            $edge.cliSettings.passwordExpiry | should be "4242"
+        }
+
+        it "Change sshLoginBannerText" {
+            Get-NsxEdge $name | Set-NsxEdge -sshLoginBannerText "Secured by Set-NsxEdge" -confirm:$false
+            $edge = Get-NsxEdge $name
+            $edge.cliSettings.sshLoginBannerText | should be "Secured by Set-NsxEdge"
+        }
+    }
+
     Context "Misc" {
 
         it "Can enable firewall via Set-NsxEdge" {