This is the built-in help made by Microsoft for the command 'Rename-Printer', 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.
Renames the specified printer.
Rename-Printer [-Name] <String> [-NewName] <String> [-AsJob [<SwitchParameter>]] [-CimSession <CimSession>] [-ThrottleLimit <Int32>] [-Confirm
[<SwitchParameter>]] [-WhatIf [<SwitchParameter>]] [<CommonParameters>]
Rename-Printer [-InputObject] <CimInstance> [-NewName] <String> [-AsJob [<SwitchParameter>]] [-CimSession <CimSession>] [-ThrottleLimit
<Int32>] [-Confirm [<SwitchParameter>]] [-WhatIf [<SwitchParameter>]] [<CommonParameters>]
The Rename-Printer cmdlet renames the specified printer on a computer. You can specify the printer to rename by using either a printer object
retrieved by Get-Printer, or by specifying a printer name.
You cannot use wildcard characters with Rename-Printer. You can use Rename-Printer in a Windows PowerShell remoting session.
You need administrator privileges to use Rename-Printer.
<
Add-Printer
Remove-Printer
Get-Printer
Set-Printer
<
Example 1: Rename a printer
PS C:\> Rename-Printer –Name "Microsoft XPS Document Writer" –NewName "MXDW"
This command renames the "Microsoft XPS Document Writer" printer name as "MXDW".
Example 2: Rename a printer by using a printer object
PS C:\> $Printer = Get-Printer –Name “Microsoft XPS Document Writer"
PS C:\> Rename-Printer -InputObject $Printer –NewName "MXDW"
This set of commands retrieves a printer object into a variable ($Printer) using Get-Printer, and then passes the contents of the variable to
Rename-Printer.