Added Remove-NSSystemFile

Author: dbroeglin

NetScaler/NetScaler.psd1

@@ -188,6 +188,7 @@ FunctionsToExport = @(
     'Remove-NSResponderAction',
     'Remove-NSSSLCertificateLink',
     'Remove-NSSSLProfile',
+    'Remove-NSSystemFile',
     'Remove-NSVPNSessionPolicy',
     'Remove-NSVPNSessionProfile',
     'Restart-NetScaler',

NetScaler/Public/Remove-NSSystemFile.ps1

@@ -0,0 +1,67 @@
+<#
+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 Remove-NSSystemFile {
+    <#
+    .SYNOPSIS
+        Remove a system file from the NetScaler.
+
+    .DESCRIPTION
+        Remove a system file from the NetScaler.
+
+    .EXAMPLE
+        Remove-NSSystemFile -Name 'test.tgz'
+
+        Remove a system file called 'test.tgz' from the NetScaler.
+
+    .PARAMETER Session
+        The NetScaler session object.
+
+    .PARAMETER Name
+        Name of the system file to remove.
+
+    .PARAMETER FileLocation
+        Location of the system file to remove.
+
+    .PARAMETER Force
+        Suppress confirmation when removing a system file.
+    #>
+    [cmdletbinding(SupportsShouldProcess = $true, ConfirmImpact='Medium')]
+    param(
+        $Session = $script:session,
+
+        [Parameter(Mandatory = $true, ValueFromPipeline = $true, ValueFromPipelineByPropertyName = $true)]
+        [Alias('Filename')]
+        [string[]]$Name,
+
+        [Parameter(Mandatory)]
+        [string]$FileLocation,
+
+        [switch]$Force
+    )
+
+    begin {
+        _AssertSessionActive
+    }
+
+    process {
+        foreach ($item in $Name) {
+            if ($Force -or $PSCmdlet.ShouldProcess($item, "Delete file $FileLocation/$Name")) {
+                _InvokeNSRestApi -Session $Session -Method DELETE -Type systemfile -Resource $item -Action delete -Arguments @{ filelocation = $FileLocation }
+            }
+        }
+    }
+}