modules/Server/public/Get-SdnVfpVmSwitchPort.ps1
|
# Copyright (c) Microsoft Corporation. # Licensed under the MIT License. function Get-SdnVfpVmSwitchPort { <# .SYNOPSIS Returns a list of ports from within virtual filtering platform. .PARAMETER PortName The port name of the VFP interface .PARAMETER VMName The Name of the Virtual Machine .PARAMETER VMID The ID of the Virtual Machine .PARAMETER ComputerName Type the NetBIOS name, an IP address, or a fully qualified domain name of one or more remote computers. .PARAMETER Credential Specifies a user account that has permission to perform this action. The default is the current user. .EXAMPLE PS> Get-SdnVfpVmSwitchPort -ComputerName 'Server01','Server02' .EXAMPLE PS> Get-SdnVfpVmSwitchPort -ComputerName 'Server01','Server02' -Credential (Get-Credential) .EXAMPLE PS> Get-SdnVfpVmSwitchPort -VMName 'SDN-MUX01' .EXAMPLE PS> Get-SdnVfpVmSwitchPort -VMID 699FBDA2-15A0-4D73-A6EF-9D55623A27CE #> [CmdletBinding(DefaultParameterSetName = 'Default')] param ( [Parameter(Mandatory = $false, Position = 1, ParameterSetName = 'Port')] [System.String]$PortName, [Parameter(Mandatory = $false, Position = 2, ParameterSetName = 'VMID')] [System.String]$VMID, [Parameter(Mandatory = $false, Position = 3, ParameterSetName = 'VMName')] [System.String]$VMName, [Parameter(Mandatory = $false, Position = 4, ParameterSetName = 'Port')] [Parameter(Mandatory = $false, Position = 4, ParameterSetName = 'VMID')] [Parameter(Mandatory = $false, Position = 4, ParameterSetName = 'VMName')] [Parameter(Mandatory = $false, Position = 4, ParameterSetName = 'Default')] [string[]]$ComputerName, [Parameter(Mandatory = $false, Position = 5, ParameterSetName = 'Port')] [Parameter(Mandatory = $false, Position = 4, ParameterSetName = 'VMID')] [Parameter(Mandatory = $false, Position = 4, ParameterSetName = 'VMName')] [Parameter(Mandatory = $false, Position = 4, ParameterSetName = 'Default')] [System.Management.Automation.PSCredential] [System.Management.Automation.Credential()] $Credential = [System.Management.Automation.PSCredential]::Empty ) try { if ($PSBoundParameters.ContainsKey('ComputerName')) { $results = Invoke-PSRemoteCommand -ComputerName $ComputerName -Credential $Credential -ScriptBlock { Get-SdnVfpVmSwitchPort } } else { $results = Get-VfpVMSwitchPort } switch ($PSCmdlet.ParameterSetName) { 'Port' { return ($results | Where-Object {$_.PortName -ieq $PortName}) } 'VMID' { return ($results | Where-Object {$_.VMID -ieq $VMID}) } 'VMName' { return ($results | Where-Object {$_.VMName -ieq $VMName}) } default { return $results } } } catch { "{0}`n{1}" -f $_.Exception, $_.ScriptStackTrace | Trace-Output -Level:Error } } |