Passer au contenu principal

Get-Printer

Récupère une liste des imprimantes installées sur un ordinateur.

Syntaxe

Get-Printer
   [[-Name] <String[]>]
   [-ComputerName <String>]
   [-Full]
   [-CimSession <CimSession[]>]
   [-ThrottleLimit <Int32>]
   [-AsJob]
   [<CommonParameters>]

Description

La cmdlet Get-Printer récupère une liste des imprimantes installées sur un ordinateur. Vous pouvez également utiliser Get-Printer pour récupérer les propriétés d'une seule imprimante, puis utiliser ces informations comme entrée dans d'autres applets de commande.

Vous pouvez utiliser des caractères génériques avec Get-Printer. Vous pouvez utiliser Get-Printer dans une session à distance Windows PowerShell.

Vous n'avez pas besoin d'informations d'identification d'administrateur pour exécuter Get-Printer.

Exemples

Exemple 1: Obtenir une liste d'imprimantes

Get-Printer

Cette commande récupère une liste d'imprimantes et de connexions d'imprimantes sur l'ordinateur local.

Exemple 2: Obtenir les informations pour une imprimante spécifique

Get-Printer -Name "Microsoft XPS Document Writer"

Cette commande récupère les informations d'une imprimante spécifique nommée Microsoft XPS Document Writer.

Exemple 3: Obtenez les informations détaillées pour une imprimante spécifique

Get-Printer -Name "Microsoft XPS Document Writer" | Format-List

Cette commande récupère des informations détaillées pour une imprimante spécifique nommée Microsoft XPS Document Writer.

Exemple 4: Obtenir une liste d'imprimantes sur un ordinateur distant

Get-Printer -ComputerName PrintServer

Cette commande récupère une liste d'imprimantes à partir de l'ordinateur nommé PrintServer.

Exemple 5: Obtenez une liste d'objets d'imprimante, puis renommez les imprimantes

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

La première commande obtient l'imprimante nommée Microsoft XPS Document Writer, puis la stocke dans la variable $Printer.

La deuxième commande renomme l'imprimante dans $Printer à l'aide de l'applet de commande Rename-Printer.

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.

 

-ComputerName

Spécifie le nom de l'ordinateur à partir duquel récupérer les informations de l'imprimante.

 

-Full

Spécifie tous les paramètres d'imprimante à récupérer, y compris RenderingMode et PermissionSDDL.

 

-Name

Spécifie le nom de l'imprimante sur laquelle récupérer les informations.

 

-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.