Public/Remove-UnityFileInterface.ps1

Function Remove-UnityFileInterface {

  <#
      .SYNOPSIS
      Delete a file interface.
      .DESCRIPTION
      Delete a Nas Server.
      You need to have an active session with the array.
      .NOTES
      Written by Erwan Quelin under Apache licence
      .LINK
      https://github.com/equelin/Unity-Powershell
      .EXAMPLE
      Remove-UnityFileInterface -ID 'if_1'
 
      Delete the file interface with ID 'if_1'
      .EXAMPLE
      Get-UnityFileInterface -Name 'if_1' | Remove-UnityFileInterface
 
      Delete the file interface with ID 'if_1'. The file interface informations are provided by the Get-UnityFileInterface through the pipeline.
  #>


    [CmdletBinding(SupportsShouldProcess = $True,ConfirmImpact = 'High')]
  Param (
    [Parameter(Mandatory = $false,HelpMessage = 'EMC Unity Session')]
    $session = ($global:DefaultUnitySession | where-object {$_.IsConnected -eq $true}),
    [Parameter(Mandatory = $true,Position = 0,ValueFromPipeline=$True,ValueFromPipelinebyPropertyName=$True,HelpMessage = 'File interface ID or Object')]
    $ID
  )

  Begin {
    Write-Verbose "Executing function: $($MyInvocation.MyCommand)"
  }

  Process {

    Foreach ($sess in $session) {

      Write-Verbose "Processing Session: $($sess.Server) with SessionId: $($sess.SessionId)"

      If (Test-UnityConnection -Session $Sess) {

        Foreach ($i in $ID) {

          # Determine input and convert to UnityFileInterface object
          Switch ($ID.GetType().Name)
          {
            "String" {
              $FileInterface = get-UnityFileInterface -Session $Sess -ID $ID
              $FileInterfaceID = $FileInterface.id
              $FileInterfaceName = $FileInterface.Name
            }
            "UnityFileInterface" {
              Write-Verbose "Input object type is $($ID.GetType().Name)"
              $FileInterfaceID = $ID.id
              If ($FileInterface = Get-UnityFileInterface -Session $Sess -ID $FileInterfaceID) {
                        $FileInterfaceName = $ID.name
              }
            }
          }

          If ($FileInterfaceID) {
            #Building the URI
            $URI = 'https://'+$sess.Server+'/api/instances/fileInterface/'+$FileInterfaceID
            Write-Verbose "URI: $URI"

            if ($pscmdlet.ShouldProcess($FileInterfaceID,"Delete File Interface")) {
              #Sending the request
              $request = Send-UnityRequest -uri $URI -Session $Sess -Method 'DELETE'
            }

            If ($request.StatusCode -eq '204') {

              Write-Verbose "File Interface with ID: $id has been deleted"

            }
          } else {
            Write-Information -MessageData "File Interface $FileInterfaceID does not exist on the array $($sess.Name)"
          }
        }
      } else {
        Write-Information -MessageData "You are no longer connected to EMC Unity array: $($Sess.Server)"
      }
    }
  }

  End {}
}