PowerShell Logo Small

Set-PrintConfiguration



This is the built-in help made by Microsoft for the command 'Set-PrintConfiguration', in PowerShell version 3 - as retrieved from Windows version 'Microsoft Windows Server 2012 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 [<SwitchParameter>]] [-CimSession <CimSession>] [-Collate <Boolean>] [-Color
<Boolean>] [-DuplexingMode <DuplexingModeEnum>] [-PaperSize <PaperSizeEnum>] [-PrintTicketXml <String>] [-ThrottleLimit <Int32>] [-Confirm
[<SwitchParameter>]] [-WhatIf [<SwitchParameter>]] [<CommonParameters>]
Set-PrintConfiguration [-PrinterName] <String> [-AsJob [<SwitchParameter>]] [-CimSession <CimSession>] [-Collate <Boolean>] [-Color <Boolean>]
[-ComputerName <String>] [-DuplexingMode <DuplexingModeEnum>] [-PaperSize <PaperSizeEnum>] [-PrintTicketXml <String>] [-ThrottleLimit <Int32>]
[-Confirm [<SwitchParameter>]] [-WhatIf [<SwitchParameter>]] [<CommonParameters>]
Set-PrintConfiguration [-InputObject] <CimInstance> [-AsJob [<SwitchParameter>]] [-CimSession <CimSession>] [-ThrottleLimit <Int32>] [-Confirm
[<SwitchParameter>]] [-WhatIf [<SwitchParameter>]] [<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

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.