Add-PrinterPort

Installe un port d'imprimante sur l'ordinateur spécifié.

Syntaxe

Add-PrinterPort
   [-Name] <String>
   [-ComputerName <String>]
   [-CimSession <CimSession[]>]
   [-ThrottleLimit <Int32>]
   [-AsJob]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Add-PrinterPort
   [-Name] <String>
   [-ComputerName <String>]
   [-SNMP <UInt32>]
   [-SNMPCommunity <String>]
   [-LprHostAddress] <String>
   [-LprQueueName] <String>
   [-LprByteCounting]
   [-CimSession <CimSession[]>]
   [-ThrottleLimit <Int32>]
   [-AsJob]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Add-PrinterPort
   [-Name] <String>
   [-ComputerName <String>]
   [-PrinterHostAddress] <String>
   [-PortNumber <UInt32>]
   [-SNMP <UInt32>]
   [-SNMPCommunity <String>]
   [-CimSession <CimSession[]>]
   [-ThrottleLimit <Int32>]
   [-AsJob]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Add-PrinterPort
   [-ComputerName <String>]
   [-HostName] <String>
   [-PrinterName] <String>
   [-CimSession <CimSession[]>]
   [-ThrottleLimit <Int32>]
   [-AsJob]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

La cmdlet Add-PrinterPort crée un port d'imprimante sur l'ordinateur spécifié. Vous pouvez créer un port d'imprimante local, un port d'imprimante à l'aide de TCP et des ports d'imprimante LPR en utilisant Add-PrinterPort.

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

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

Exemples

Exemple 1: Créer un port d'imprimante local

Add-PrinterPort -Name "LocalPort:"

Cette commande crée un port d'imprimante local nommé LocalPort sur l'ordinateur local.

Exemple 2: Créer un port d'imprimante TCP

Add-PrinterPort -Name "TCPPort:" -PrinterHostAddress "192.168.100.100"

Cette commande crée un port d'imprimante TCP nommé TCPPort: avec l'adresse IP 192.168.100.100 sur l'ordinateur.

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 auquel ajouter le port de l'imprimante. Si vous ne spécifiez pas de valeur, le port de l'imprimante est ajouté à l'ordinateur local.

 

-Confirm

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

 

-HostName

Spécifie le nom d'hôte de l'ordinateur sur lequel ajouter le port d'imprimante LPR.

 

-LprByteCounting

Indique que cette applet de commande active le comptage d'octets LPR pour un port d'imprimante TCP/IP en mode LPR.

 

-LprHostAddress

Spécifie l'adresse hôte LPR lors de l'installation d'un port d'imprimante TCP/IP en mode LPR.

 

-LprQueueName

Spécifie le nom de file d'attente LPR lors de l'installation d'un port d'imprimante TCP/IP en mode LPR.

 

-Name

Spécifie le nom du port d'imprimante à installer sur l'ordinateur spécifié.

 

-PortNumber

Spécifie le numéro de port TCP/IP pour le port d'imprimante ajouté à l'ordinateur spécifié.

 

-PrinterHostAddress

Spécifie l'adresse hôte du port d'imprimante TCP/IP ajouté à l'ordinateur spécifié.

 

-PrinterName

Spécifie le nom de l'imprimante installée sur le port d'imprimante LPR.

 

-SNMP

Active SNMP et spécifie l'index pour la gestion de port d'imprimante TCP/IP.

 

-SNMPCommunity

Spécifie le nom de communauté SNMP pour la gestion des ports d'imprimante TCP/IP.

 

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