PowerShell Logo Small

Set-PrintConfiguration



This is the built-in help made by Microsoft for the command 'Set-PrintConfiguration', in PowerShell version 5 - as retrieved from Windows version 'Microsoft Windows Server 2012 R2 Standard' PowerShell help files on 2016-06-23.

For PowerShell version 3 and up, where you have Update-Help, this command was run just before creating the web pages from the help files.

SYNOPSIS

Sets the configuration information for the specified printer.

SYNTAX


Set-PrintConfiguration [-PrinterObject] <CimInstance> [-AsJob] [-CimSession <CimSession[]>] [-Collate <Boolean>] [-Color <Boolean>] [-DuplexingMode <DuplexingModeEnum>]
[-PaperSize <PaperSizeEnum>] [-PrintTicketXml <String>] [-ThrottleLimit <Int32>] [-Confirm] [-WhatIf] [<CommonParameters>]
Set-PrintConfiguration [-InputObject] <CimInstance> [-AsJob] [-CimSession <CimSession[]>] [-ThrottleLimit <Int32>] [-Confirm] [-WhatIf] [<CommonParameters>]
Set-PrintConfiguration [-PrinterName] <String> [-AsJob] [-CimSession <CimSession[]>] [-Collate <Boolean>] [-Color <Boolean>] [-ComputerName <String>] [-DuplexingMode
<DuplexingModeEnum>] [-PaperSize <PaperSizeEnum>] [-PrintTicketXml <String>] [-ThrottleLimit <Int32>] [-Confirm] [-WhatIf] [<CommonParameters>]



Search powershellhelp.space

DESCRIPTION


The Set-PrintConfiguration cmdlet sets the printer configuration for the specified printer. Using the Set-PrintConfiguration cmdlet, you can manage the configuration of the
following features:


● Collate

● Color

● Duplexing Mode

● N-Up

● Paper Size


The Set-PrintConfiguration cmdlet also accepts print configuration objects using Get-PrintConfiguration cmdlet.




You cannot use wildcard characters with Set-PrintConfiguration. You can use Set-PrintConfiguration in a Windows PowerShell remoting session.

You need administrator privileges to use Set-PrintConfiguration.




<

RELATED LINKS

Online Version: http://go.microsoft.com/fwlink/?LinkId=289478
Get-PrintConfiguration

REMARKS

<

Examples


Example 1: Set the default paper size

PS C:\> Set-PrintConfiguration –PrinterName "Microsoft XPS Document Writer" -PaperSize A4



This command sets the default paper size of the printer named "Microsoft XPS Document Writer" printer to A4.




Example 2: Set the default paper size using print configuration object

PS C:\>$PrintConfiguration = Get-PrintConfiguration –PrinterName "Microsoft XPS Document Writer"


PS C:\>$PrintConfiguration.paperSize = A4


PS C:\>Set-PrintConfiguration –InputObject $PrintConfiguration



This set of commands retrieves a print configuration object into a variable ($PrintConfiguration) using Get-PrintConfiguration, sets the paper size in the printer
configuration object to A4 and then passes the contents of the variable to Set-PrintConfiguration.




Example 3: Set the default paper size of all printers

PS C:\>$printers = get-printer * foreach ($printer in $printers){     Set-printconfiguration –printerName $printer.name -PaperSize A4}



This command gets all the printers into a variable $printers and then loops through all the printers and displays the properties.