PowerShell Logo Small

Remove-PrinterPort



This is the built-in help made by Microsoft for the command 'Remove-PrinterPort', in PowerShell version 3 - as retrieved from Windows version 'Microsoft Windows Server 2012 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 [<SwitchParameter>]] [-CimSession <CimSession>] [-ComputerName <String>] [-PassThru
[<SwitchParameter>]] [-ThrottleLimit <Int32>] [-Confirm [<SwitchParameter>]] [-WhatIf [<SwitchParameter>]] [<CommonParameters>]
Remove-PrinterPort [-AsJob [<SwitchParameter>]] [-CimSession <CimSession>] [-PassThru [<SwitchParameter>]] [-ThrottleLimit <Int32>]
-InputObject <CimInstance> [-Confirm [<SwitchParameter>]] [-WhatIf [<SwitchParameter>]] [<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

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.