PowerShell Logo Small

Remove-PrinterPort



This is the built-in help made by Microsoft for the command 'Remove-PrinterPort', in PowerShell version 5 - as retrieved from Windows version 'Microsoft Windows Server 2012 R2 Standard' PowerShell help files on 2016-06-23.

For PowerShell version 3 and up, where you have Update-Help, this command was run just before creating the web pages from the help files.

SYNOPSIS

Removes the specified printer port from the specified computer.

SYNTAX


Remove-PrinterPort [-Name] <String[]> [-AsJob] [-CimSession <CimSession[]>] [-ComputerName <String>] [-PassThru] [-ThrottleLimit <Int32>] [-Confirm] [-WhatIf]
[<CommonParameters>]
Remove-PrinterPort [-AsJob] [-CimSession <CimSession[]>] [-PassThru] [-ThrottleLimit <Int32>] -InputObject <CimInstance[]> [-Confirm] [-WhatIf] [<CommonParameters>]



Search powershellhelp.space

DESCRIPTION


The Remove-PrinterPort cmdlet removes the specified printer port from the specified computer.


You can remove a printer port by specifying the port name, or you can use a printer object retrieved using Get-PrinterPort.


You can use wildcard characters with Remove-PrinterPort. You can use Remove-PrinterPort in a Windows PowerShell remoting session.


You do not need administrator privileges to use Remove-PrinterPort.



<

RELATED LINKS

Online Version: http://go.microsoft.com/fwlink/?LinkId=289473
Get-PrinterPort
Add-PrinterPort

REMARKS

<

Examples


Example 1: Remove a specified printer port

PS C:\> Remove-PrinterPort -Name "LocalPort:"



This command removes the printer port named LocalPort: from the computer.




Example 2: Remove a specified printer port using a printer port object

PS C:\>$printerPort = Get-PrinterPort -Name "LocalPort:"


PS C:\>Remove-PrinterPort –InputObject $printerPort



This set of commands retrieves a printer port object into a variable ($printerPort) using Get-PrinterPort, and then passes the variable to Remove-PrinterPort.