Set-Printer

Mise à jour de la configuration d'une imprimante existante.

Syntaxe

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

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

Description

La cmdlet Set-Printer met à jour la configuration de l'imprimante spécifiée.

Utilisez le paramètre KeepPrintedJobs pour conserver les travaux imprimés.

Vous pouvez spécifier l'imprimante à mettre à jour à l'aide d'un objet d'imprimante récupéré par l'applet de commande Get-Printer ou en spécifiant un nom d'imprimante.

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

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

Exemples

Exemple 1: Réglez l'imprimante en conservant les travaux imprimés

Set-Printer -Name "Microsoft XPS Document Writer" -KeepPrintedJobs $True

Cette commande configure l'imprimante Microsoft XPS Document Writer pour conserver les travaux imprimés.

Exemple 2: Configurez l'imprimante en conservant les travaux imprimés à l'aide d'un objet d'imprimante

$Printer = Get-Printer -Name "Microsoft XPS Document Writer"
$Printer.KeepPrintedJobs = $True
Set-Printer -InputObject $Printer

La première commande obtient l'imprimante nommée Microsoft XPS Document Writer à l'aide de l'applet de commande Get-Printer. La commande stocke le résultat dans la variable $Printer.

La deuxième commande attribue une valeur de $True au paramètre KeepPrintedJobs de l'objet imprimante $Printer.

La commande finale définit la valeur de la valeur révisée de $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.

-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 sur lequel l'imprimante est installée.

 

-Confirm

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

 

-Datatype

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

 

-DisableBranchOfficeLogging

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

 

-InputObject

Spécifie l'objet d'entrée utilisé dans une commande de pipeline.

 

-KeepPrintedJobs

Spécifie si les travaux d'imprimante dans la file d'attente sont conservés.

 

-Location

Spécifie l'emplacement de l'imprimante.

 

-Name

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

 

-PassThru

Renvoie un objet représentant l'élément avec lequel vous travaillez. Par défaut, cette applet de commande ne génère aucune sortie.

 

-PermissionSDDL

Spécifie les autorisations pour l'imprimante en tant que chaîne 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.

Valeurs acceptées : SSR, RSE, BranchOffice

 

-SeparatorPageFile

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

 

-Shared

Spécifie si l'imprimante est partagée.

 

-ShareName

Spécifie le nom par lequel partager l'imprimante sur le réseau. Pour modifier l'état de partage d'une imprimante, spécifiez Partagé paramètre.

 

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