Started adding HA function (WIP)

Author: dbroeglin

NetScaler/NetScaler.psd1

@@ -92,6 +92,7 @@ FunctionsToExport = @(
     'Disable-NSLBVirtualServer',
     'Disable-NSMode',
     'Disconnect-NetScaler',
+    'Enable-NSHighAvailability',
     'Enable-NSFeature',
     'Enable-NSLBMonitor',
     'Enable-NSLBServer',

NetScaler/Private/_AssertSessionActive.ps1

@@ -15,8 +15,11 @@ limitations under the License.
 #>
 
 function _AssertSessionActive {
-    $s = $script:session
-    if ($null -eq $s ) {
+    param(
+        $Session = $script:session
+    )
+
+    if ($null -eq $session) {
         throw 'Must be logged into NetScaler appliance first!'
     }
 }

NetScaler/Public/Enable-NSHighAvailability.ps1

@@ -0,0 +1,73 @@
+<#
+Copyright 2017 Dominique Broeglin
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+#>
+
+function Enable-NSHighAvailability {
+    <#
+    .SYNOPSIS
+        Enable high-availability between two NetScaler instances.
+
+    .DESCRIPTION
+        Enable high-availability between two NetScaler instances.
+
+    .EXAMPLE
+        Enable-NSHighAvailability -PrimarySession $ns1 -SecondarySession Session $ns2
+
+        Enable high-availability between the netscaler instances corresponding to 
+        the already opened $ns1 and $ns2.
+
+    .PARAMETER PrimarySession
+        The NetScaler session object for the first NetScaler instance (will end up master).
+
+    .PARAMETER SecondarySession
+        The NetScaler session object for the second NetScaler instance (will end up slave).
+
+    .PARAMETER PeerNodeId
+        The node id used to denote the peer.
+
+        Default value: 1
+
+    .PARAMETER Force
+        Suppress confirmation when activating high-availability.
+    #>
+    [CmdletBinding(SupportsShouldProcess = $true, ConfirmImpact='High')]
+    param(
+        [parameter(Mandatory)]
+        $PrimarySession,
+
+        [parameter(Mandatory)]
+        $SecondarySession,
+
+        [int]$PeerNodeId = 1,
+
+        [switch]$Force
+    )
+
+    begin {
+        _AssertSessionActive -Session $PrimarySession
+        _AssertSessionActive -Session $SecondarySession
+    }
+
+    process {
+        if ($Force -or $PSCmdlet.ShouldProcess($item, 'Enable high-availability')) {
+            try {
+                
+
+            } catch {
+                throw $_
+            }
+        }
+    }
+}

NetScaler/Public/Get-NSConfig.ps1

@@ -58,6 +58,6 @@ function Get-NSConfig {
         } else {
             $Config = (_InvokeNSRestApi -Session $Session -Method Get -Type nssavedconfig -Action GetAll).nssavedconfig.textblob            
         }
-        $Config -Split '\n' | ? { $_ -and !($_ -match "^( Done| *#)") }
+        $Config -Split '\n' | Where-Object { $_ -and !($_ -match "^( Done| *#)") }
     }
 }