Rename-Printer

Rename-Printer

Renames the specified printer.

Syntax

Parameter Set: name
Rename-Printer [-Name] <String> [-NewName] <String> [-AsJob] [-CimSession <CimSession[]> ] [-ThrottleLimit <Int32> ] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: object
Rename-Printer [-InputObject] <CimInstance> [-NewName] <String> [-AsJob] [-CimSession <CimSession[]> ] [-ThrottleLimit <Int32> ] [-Confirm] [-WhatIf] [ <CommonParameters>]

Detaillierte Beschreibung

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.

Parameter

-AsJob

-CimSession<CimSession[]>

Führt das Cmdlet in einer Remotesitzung oder auf einem Remotecomputer aus. Geben Sie einen Computernamen oder ein Sitzungsobjekt ein, z. B. die Ausgabe eines Cmdlets New-CimSession oder Get-CimSession. Der Standardwert ist die aktuelle Sitzung auf dem lokalen Computer.

-InputObject<CimInstance>

Specifies the object which contains the printer to rename.

-Name<String>

Specifies the name of the printer to rename.

-NewName<String>

Specifies the new name of the printer.

-ThrottleLimit<Int32>

Gibt die maximale Anzahl von gleichzeitigen Vorgängen an, die zum Ausführen dieses Cmdlets eingerichtet werden können. Wenn dieser Parameter ausgelassen oder der Wert 0 eingegeben wird, berechnet Windows PowerShell® einen optimalen Drosselungsgrenzwert für das Cmdlet basierend auf der Anzahl der CIM-Cmdlets, die auf dem Computer ausgeführt werden. Die Drosselungsgrenze gilt nur für das aktuelle Cmdlet und nicht für die Sitzung oder den Computer.

-Confirm

Sie werden vor dem Ausführen des Cmdlets zur Bestätigung aufgefordert.

-WhatIf

Zeigt, was geschieht, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

<CommonParameters>

Dieses Cmdlet unterstützt die allgemeinen Parameter: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, -OutVariable. Weitere Informationen finden Sie unter about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).

Eingaben

Der Eingabetyp ist der Typ der Objekte, die über die Pipeline an das Cmdlet übergeben werden können.

• Microsoft.Management.Infrastructure.CimInstance#ROOT/StandardCimv2/MSFT_Printer

  This cmdlet accepts one printer object.

Ausgaben

Der Ausgabetyp ist der Typ der Objekte, die vom Cmdlet ausgegeben werden.

• This cmdlet produces no output.

Beispiele

Example 1: Rename a printer

This command renames the "Microsoft XPS Document Writer" printer name as "MXDW".

PS C:\> Rename-Printer –Name "Microsoft XPS Document Writer" –NewName "MXDW"

Example 2: Rename a printer by using a printer object

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.

PS C:\> $Printer = Get-Printer –Name “Microsoft XPS Document Writer"

PS C:\> Rename-Printer -InputObject $Printer –NewName "MXDW"

Verwandte Themen

Add-Printer

Remove-Printer

Get-Printer

Set-Printer