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.