Add-Printer

Ajoute une imprimante sur l'ordinateur spécifié.

Syntaxe

Add-Printer
   [-ConnectionName] <String>
   [-CimSession <CimSession[]>]
   [-ThrottleLimit <Int32>]
   [-AsJob]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Add-Printer
   [-Comment <String>]
   [-Datatype <String>]
   [-UntilTime <UInt32>]
   [-KeepPrintedJobs]
   [-Location <String>]
   [-SeparatorPageFile <String>]
   [-ComputerName <String>]
   [-Shared]
   [-ShareName <String>]
   [-StartTime <UInt32>]
   [-Name] <String>
   [-PermissionSDDL <String>]
   [-PrintProcessor <String>]
   [-Priority <UInt32>]
   [-Published]
   [-RenderingMode <RenderingModeEnum>]
   [-DisableBranchOfficeLogging]
   [-BranchOfficeOfflineLogSizeMB <UInt32>]
   [-WorkflowPolicy <WorkflowPolicyEnum>]
   [-DeviceURL <String>]
   [-DeviceUUID <String>]
   [-IppURL <String>]
   [-CimSession <CimSession[]>]
   [-ThrottleLimit <Int32>]
   [-AsJob]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Add-Printer
   [-Comment <String>]
   [-Datatype <String>]
   [-DriverName] <String>
   [-UntilTime <UInt32>]
   [-KeepPrintedJobs]
   [-Location <String>]
   [-SeparatorPageFile <String>]
   [-ComputerName <String>]
   [-Shared]
   [-ShareName <String>]
   [-StartTime <UInt32>]
   [-Name] <String>
   [-PermissionSDDL <String>]
   [-PrintProcessor <String>]
   [-Priority <UInt32>]
   [-Published]
   [-RenderingMode <RenderingModeEnum>]
   -PortName <String>
   [-DisableBranchOfficeLogging]
   [-BranchOfficeOfflineLogSizeMB <UInt32>]
   [-WorkflowPolicy <WorkflowPolicyEnum>]
   [-CimSession <CimSession[]>]
   [-ThrottleLimit <Int32>]
   [-AsJob]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Le cmdlet Add-Printer ajoute une imprimante sur un ordinateur spécifié. Vous pouvez ajouter des imprimantes locales et des connexions aux imprimantes réseau.

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

Vous pouvez avoir besoin d'informations d'identification Administrateur pour exécuter Add-Printer.

Exemples

Example 1 : Ajouter une imprimante sur l'ordinateur local

Add-Printer -Name "mxdw 2" -DriverName "Microsoft XPS Document Writer v4" -PortName "portprompt:"

Cette commande ajoute une imprimante avec le nom mxdw 2 sur l'ordinateur local. L'imprimante mxdw 2 utilise le pilote Microsoft XPS Document Writer v4 et le port portprompt:.

Example 2 : Ajouter une nouvelle connexion d'imprimante réseau

Add-Printer -ConnectionName \\printServer\printerName

Cette commande ajoute une imprimante en spécifiant le nom d'un serveur d'impression et d'une imprimante partagée sur ce serveur.

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.

-BranchOfficeOfflineLogSizeMB

Spécifie la taille maximale, en mégaoctets, du fichier journal hors ligne distant de la succursale pour cette imprimante. Vous ne pouvez pas spécifier ce paramètre pour les files d'attente non partagées ou les files d'attente qui n'ont pas activé la succursale.

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

-Comment

Spécifie le texte à ajouter au champ Commentaire pour l'imprimante spécifiée.

-ComputerName

Spécifie le nom de l'ordinateur auquel ajouter l'imprimante.

-Confirm

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

-ConnectionName

Spécifie le nom d'une imprimante partagée à laquelle se connecter. Ce paramètre est requis.

-Datatype

Spécifie le type de données utilisé par l'imprimante pour enregistrer les travaux d'impression.

-DeviceURL

Spécifie une URL pour la découverte dirigée d'une imprimante Web Services on Devices (WSD) à ajouter sur l'ordinateur spécifié.

-DeviceUUID

Spécifie l'UUID multicast pour la détection de périphérique pour le port WSD.

-DisableBranchOfficeLogging

Indique que la journalisation à distance des succursales est désactivée. Vous ne pouvez pas spécifier ce paramètre pour les files non partagées.

-DriverName

Spécifie le nom du pilote d'imprimante pour l'imprimante.

-IppURL

Spécifie une URL ou un nom d'hôte ou une adresse IP pour la découverte dirigée d'une imprimante IPP (Internet Printing Protocol) à ajouter sur l'ordinateur spécifié.

-KeepPrintedJobs

Spécifie si les tâches d'impression dans la file d'attente sont conservées.

-Location

Spécifie l'emplacement de l'imprimante.

-Name

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

-PermissionSDDL

Spécifie les autorisations pour l'imprimante en tant que chaîne Security Descriptor Definition Language (SDDL).

-PortName

Spécifie le nom du port utilisé ou créé pour l'imprimante.

-PrintProcessor

Spécifie le nom du processeur d'impression utilisé par l'imprimante.

-Priority

Spécifie la priorité relative de la file d'attente

-Published

Spécifie si l'imprimante est publiée dans le service d'annuaire réseau.

-RenderingMode

Spécifie le mode de rendu de l'imprimante. Vous pouvez spécifier l'un des modes de rendu suivants:

• • • SSR, Service Side Rendering
    • CSR. Client Side Rendering
    • BranchOffice. Branch Office

-SeparatorPageFile

Spécifie le chemin et le nom de la page de séparation à utiliser par l'imprimante.

-Shared

Indique s'il faut partager l'imprimante sur le réseau. Vous pouvez déterminer le nom par lequel l'imprimante est partagée en spécifiant ShareName. Si ShareName n'est pas spécifié, le nom de l'imprimante est utilisé comme nom de partage.

-ShareName

Spécifie le nom par lequel partager l'imprimante sur le réseau. Pour partager une imprimante, spécifiez le paramètre Shared.

-StartTime

Spécifie l'heure de démarrage de la disponibilité 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.

-UntilTime

Spécifie l'heure de fin de la disponibilité de l'imprimante.

-WhatIf

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

-WorkflowPolicy

Permet à un administrateur d'associer une imprimante donnée à une application Workflow spécifique. Ce paramètre ne permet pas à l'administrateur de remplacer l'association périphérique-application créée à l'aide du service de métadonnées de périphérique.