PowerShell Logo Small


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.


Removes the specified printer port from the specified computer.


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

Search powershellhelp.space


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.



Online Version: http://go.microsoft.com/fwlink/?LinkId=289473




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.