Set-PrinterProperty

Set-PrinterProperty

Modifies the printer properties for the specified printer.

Syntax

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

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

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

Detaillierte Beschreibung

The Set-PrinterProperty cmdlet modifies the printer properties for the specified printer.

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

You need administrator privileges to use Set-PrinterProperty.

Parameter

-AsJob

-CimSession<CimSession[]>

Führt das Cmdlet in einer Remotesitzung oder auf einem Remotecomputer aus. Geben Sie einen Computernamen oder ein Sitzungsobjekt ein, z. B. die Ausgabe eines Cmdlets New-CimSession oder Get-CimSession. Der Standardwert ist die aktuelle Sitzung auf dem lokalen Computer.

-ComputerName<String>

Specifies the computer name for which to modify the printer properties.

-InputObject<CimInstance>

Specifies the printer property object which contains the printer property to modify.

-PrinterName<String>

Specifies the name of the printer for which to modify the properties.

-PrinterObject<CimInstance>

Specifies the printer object for which to update the printer properties.

-PropertyName<String>

Specifies the property name to update.

-ThrottleLimit<Int32>

Gibt die maximale Anzahl von gleichzeitigen Vorgängen an, die zum Ausführen dieses Cmdlets eingerichtet werden können. Wenn dieser Parameter ausgelassen oder der Wert 0 eingegeben wird, berechnet Windows PowerShell® einen optimalen Drosselungsgrenzwert für das Cmdlet basierend auf der Anzahl der CIM-Cmdlets, die auf dem Computer ausgeführt werden. Die Drosselungsgrenze gilt nur für das aktuelle Cmdlet und nicht für die Sitzung oder den Computer.

-Value<String>

Specifies the new value of the printer property.

-Confirm

Sie werden vor dem Ausführen des Cmdlets zur Bestätigung aufgefordert.

-WhatIf

Zeigt, was geschieht, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

<CommonParameters>

Dieses Cmdlet unterstützt die allgemeinen Parameter: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, -OutVariable. Weitere Informationen finden Sie unter about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).

Eingaben

Der Eingabetyp ist der Typ der Objekte, die über die Pipeline an das Cmdlet übergeben werden können.

• Microsoft.Management.Infrastructure.CimInstance#ROOT/StandardCimv2/MSFT_Printer

  This cmdlet accepts one printer object.

Ausgaben

Der Ausgabetyp ist der Typ der Objekte, die vom Cmdlet ausgegeben werden.

• This cmdlet produces no output.

Beispiele

Example 1: Set a printer property

This command sets the Config:PropertyName property of the printer named printer2 to True.

PS C:\> Set-PrinterProperty -PrinterName printer2 -PropertyName "Config:PropertyName" -Value True

Verwandte Themen

Get-PrinterProperty