Rename-Printer

Renomme l'imprimante spécifiée.

Syntaxe

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

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

Description

La cmdlet Rename-Printer renomme l'imprimante spécifiée sur un ordinateur. Vous pouvez spécifier l'imprimante à renommer en utilisant soit un objet d'imprimante récupéré par l'applet de commande Get-Printer, soit en spécifiant un nom d'imprimante.

Vous ne pouvez pas utiliser de caractères génériques avec Rename-Printer. Vous pouvez utiliser Rename-Printer dans une session à distance Windows PowerShell.

Vous avez besoin des informations d'identification d'administrateur pour exécuter Rename-Printer.

Exemples

Exemple 1: Renommer une imprimante

Rename-Printer -Name "Microsoft XPS Document Writer" -NewName "MXDW"

Cette commande renomme le nom de l'imprimante Microsoft XPS Document Writer en MXDW.

Exemple 2: Renommer une imprimante à l'aide d'un objet imprimante

$Printer = Get-Printer -Name "Microsoft XPS Document Writer"
Rename-Printer -InputObject $Printer -NewName "MXDW"

La première commande obtient une imprimante nommée Microsoft XPS Document Writer en utilisant Get-Printer. La commande stocke le résultat dans la variable $Printer.

La deuxième commande renomme l'imprimante dans $Printer en MXDW.

Paramètres

-AsJob

Exécute l'applet de commande en tant que tâche d'arrière-plan. Utilisez ce paramètre pour exécuter des commandes qui prennent beaucoup de temps.

-CimSession

Exécute l'applet de commande dans une session distante ou sur un ordinateur distant. Entrez un nom d'ordinateur ou un objet de session, tel que la sortie d'un applet New-CimSession ou Get-CimSession. La valeur par défaut est la session en cours sur l'ordinateur local.

 

-Confirm

Vous invite à confirmer avant d'exécuter l'applet de commande.

 

-InputObject

Spécifie l'objet d'entrée utilisé dans une commande de pipeline.

 

-Name

Spécifie le nom de l'imprimante à renommer.

 

-NewName

Spécifie le nouveau nom de l'imprimante.

 

-ThrottleLimit

Spécifie le nombre maximal d'opérations simultanées qui peuvent être établies pour exécuter l'applet de commande. Si ce paramètre est omis ou si une valeur de 0 est entré, Windows PowerShell® calcule une limite d'accélération optimale pour l'applet de commande en fonction du nombre d'applets de commande CIM en cours d'exécution sur l'ordinateur. La limite d'accélération s'applique uniquement à l'applet de commande actuelle, et non à la session ou à l'ordinateur.

-WhatIf

Montre ce qui se passerait si l'applet de commande s'exécute. L'applet de commande n'est pas exécutée.