Set-PrinterProperty

Modifie les propriétés de l'imprimante pour l'imprimante spécifiée.

Syntaxe

Set-PrinterProperty
   [-PrinterName] <String>
   [-PropertyName] <String>
   [-Value] <String>
   [-ComputerName <String>]
   [-CimSession <CimSession[]>]
   [-ThrottleLimit <Int32>]
   [-AsJob]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-PrinterProperty
   [-PropertyName] <String>
   [-Value] <String>
   [-PrinterObject] <CimInstance>
   [-CimSession <CimSession[]>]
   [-ThrottleLimit <Int32>]
   [-AsJob]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-PrinterProperty
   [-InputObject] <CimInstance>
   [-CimSession <CimSession[]>]
   [-ThrottleLimit <Int32>]
   [-AsJob]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

La cmdlet Set-PrinterProperty modifie les propriétés de l'imprimante pour l'imprimante spécifiée.

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

Vous avez besoin des informations d'identification d'administrateur pour exécuter Set-PrinterProperty.

Exemples

Exemple 1: Définir une propriété d'imprimante

Set-PrinterProperty -PrinterName "Printer02" -PropertyName "Config:PropertyName" -Value True

Cette commande définit la propriété Config:PropertyName de l'imprimante nommée Printer02 à True.

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 pour lequel modifier les propriétés de l'imprimante.

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

 

-PrinterName

Spécifie le nom de l'imprimante pour laquelle modifier les propriétés.

 

-PrinterObject

Spécifie l'objet imprimante pour lequel mettre à jour les propriétés de l'imprimante.

 

-PropertyName

Spécifie le nom de la propriété à mettre à jour.

 

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

 

-Value

Spécifie la nouvelle valeur de la propriété printer.

 

-WhatIf

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