rundll32 printui.dll,PrintUIEntry

适用范围:Windows Server 2022、Windows Server 2019、Windows Server 2016、Windows Server 2012 R2、Windows Server 2012

自动执行许多打印机配置任务。 printui.dll 是可执行文件,包含打印机配置对话框使用的函数。 可在脚本或命令行批处理文件中调用这些函数,也可从命令提示符处以交互方式运行它们。

语法

rundll32 printui.dll PrintUIEntry [baseparameter] [modificationparameter1] [modificationparameter2] [modificationparameterN]

还可使用以下替代语法,尽管本主题中的示例使用前面的语法:

rundll32 printui.dll,PrintUIEntry [baseparameter] [modificationparameter1] [modificationparameter2] [ModificationParameterN]
rundll32 printui PrintUIEntry [baseparameter] [modificationparameter1] [modificationparameter2] [modificationparameterN]
rundll32 printui,PrintUIEntry [baseparameter] [modificationparameter1] [modificationparameter2] [modificationparameterN]

参数

有两种类型的参数:基参数和修改参数。 基参数指定命令要执行的函数。 给定的命令行中只能显示一个基参数。 如果修改参数适用于基参数,则可以使用一个或多个修改参数来修改基参数(并非所有基参数都支持所有修改参数)。

基参数 说明
/dl 删除本地打印机。
/dn 删除网络打印机连接。
/dd 删除打印机驱动程序。
/e 显示给定打印机的打印首选项。
/ga 添加单台计算机的打印机连接(该计算机上的任何用户在登录时都可使用该连接)。
/ge 显示计算机上单台计算机的打印机连接。
/gd 删除单台计算机的打印机连接(用户下次登录时将删除该连接)。
/ia 使用 .inf 文件安装打印机驱动程序。
/id 使用“添加打印机驱动程序向导”安装打印机驱动程序。
/if 使用 .inf 文件安装打印机。
/ii 使用添加打印机向导和 .inf 文件安装打印机。
/il 使用添加打印机向导安装打印机。
/in 连接到远程网络打印机。
/ip 使用网络打印机安装向导(可从“打印管理”的用户界面访问)安装打印机。
/k 在打印机上打印测试页。
/o 显示打印机的队列。
/p 显示打印机的属性。 使用此参数时,还必须为修改参数 /n[name] 指定值
/s 显示打印服务器的属性。 如果要查看本地打印服务器,则无需使用修改参数。 但是,如果要查看远程打印服务器,则必须指定 /c[name] 修改参数
/Ss 指定将存储打印机的信息类型。 如果未指定 /Ss 的值,则默认行为与指定了所有值一样。 将此基参数与放置在命令行末尾的以下值一起使用:
  • 2:存储打印机的 printER_INFO_2 结构中包含的信息。 此结构包含打印机的基本信息,例如打印机名、服务器名、端口名和共享名。
  • 7:用于存储 printER_INFO_7 结构中包含的目录服务信息。
  • c:用于存储打印机的颜色配置文件信息。
  • d:用于存储打印机特定数据,例如打印机的硬件 ID。
  • s:用于存储打印机的安全描述符。
  • g:将信息存储在打印机的全局 DEVmode 结构中。
  • m:用于存储打印机的最小设置。 此项等效于指定 2、d 和 g
  • u:将信息存储在打印机的每用户 DEVmode 结构中。
/Sr 指定应还原有关打印机的哪些信息以及如何处理设置中的冲突。 与放置在命令行末尾的以下值一起使用:
  • 2:还原打印机的 printER_INFO_2 结构中包含的信息。 此结构包含打印机的基本信息,例如打印机名、服务器名、端口名和共享名。
  • 7:还原 printER_INFO_7 结构中包含的目录服务信息。
  • c:还原打印机的颜色配置文件信息。
  • d:还原打印机特定数据,例如打印机的硬件 ID。
  • s:还原打印机的安全描述符。
  • g:还原打印机的全局 DEVmode 结构中的信息。
  • m:还原打印机的最小设置。 此项等效于指定 2、d 和 g
  • u:还原打印机的每用户 DEVmode 结构中的信息。
  • r:如果文件中存储的打印机名与要还原到的打印机的名称不同,请使用当前打印机名。 无法使用 f 指定此项。 如果既未指定 r,也未指定 f,并且名称不匹配,则还原设置将失败
  • f:如果文件中存储的打印机名与要还原到的打印机的名称不同,则使用文件中的打印机名。 无法使用 r 指定此项。 如果未指定既未指定 f,也未指定 r,并且名称不匹配,则还原设置将失败
  • p:如果要从中还原的文件中的端口名与要还原到的打印机的当前端口名不匹配,则使用打印机的当前端口名。
  • h:如果无法使用已保存设置文件中的资源共享名共享要还原到的打印机,则尝试使用当前共享名或新生成的共享名共享打印机(如果既未指定 H,也未指定 h),如果无法使用保存的共享名共享要还原到的打印机,则还原将失败
  • h:如果无法使用保存的共享名共享还原到的打印机,则不要共享打印机。 如果既未指定 H,也未指定 h,并且无法使用保存的共享名共享要还原到的打印机,则还原将失败
  • i:如果保存的设置文件中的驱动程序与要还原到的打印机的驱动程序不匹配,则还原将失败。
/Xg 检索打印机的设置。
/Xs 设置打印机的设置。
/y 将要安装的打印机设置为默认打印机。
/? 显示命令及其关联参数的产品内帮助。
@[file] 指定命令行参数文件,并将该文件中的文本直接插入命令行。
修改参数 说明
/a[file] 指定二进制文件名。
/b[name] 指定二进制打印机名称。
/c[name] 如果要执行的操作在远程计算机上,则指定计算机名。
/f[file] 指定 .inf 文件名或输出文件名的通用命名约定 (UNC) 路径和名称,具体取决于要执行的任务。 使用 /F[file] 指定依赖的 .inf 文件
/F[file] 指定使用 /f[file] 指定的 .inf 文件所依赖的 .inf 文件的 UNC 路径和名称
/h[architecture] 指定驱动程序体系结构。 使用以下方法之一:x86、x64 或 Itanium
/j[provider] 指定打印提供程序名称。
/l[path] 指定所使用的打印机驱动程序文件所在的 UNC 路径。
/m[model] 指定驱动程序模型名称。 (可在 .inf 文件中指定此值。)
/n[name] 指定打印机名称。
/q 运行命令,但不通知用户。
/r[port] 指定端口名称。
/u 指定使用现有打印机驱动程序(如果已安装)。
/t[#] 指定要从 0 开始的索引页。
/v[version] 指定驱动程序版本。 如果也未指定 /K 的值,则必须指定以下值之一:类型 2 - 内核模式 或类型 3 - 用户模式
/W 如果在 /f 指定的 .inf 文件中找不到驱动程序,则提示用户输入驱动程序
/Y 指定不应自动生成打印机名称。
/z 指定不要自动共享正在安装的打印机。
/K 更改参数 /h[architecture] 的含义,使其接受 2 代替 x86、接受 3 代替 x64 或接受 4 代替 Itanium。 另外,更改参数 /v[version] 的值,使其接受 2 代替“类型 2 - 内核模式”并接受 3 代替“类型 3 - 用户模式”
/Z 共享正在安装的打印机。 仅与 /if 参数一起使用
/Mw[message] 在提交命令行中指定的更改之前,向用户显示一条警告消息。
/Mq[message] 在提交命令行中指定的更改之前,向用户显示一条确认消息。
/W[flags] 为“添加打印机向导”、“添加打印机驱动程序向导”和“网络打印机安装向导”指定任何参数或选项。

r:使向导能够从最后一页重启。

/G[flags] 指定要使用的全局参数和选项。

w:禁止向用户显示安装驱动程序警告。

备注

  • PrintUIEntry 关键字区分大小写,因此输入此命令的语法时大小写必须完全相符,如本主题中的示例所示

  • 有关更多示例,请在命令提示符下键入 rundll32 printui.dll,PrintUIEntry /?

示例

若要为计算机“Client1”添加新的远程打印机 printer1(对于运行此命令的用户帐户可见),请键入:

rundll32 printui.dll PrintUIEntry /in /n\\client1\printer1

若要使用“添加打印机向导”和 .inf 文件 InfFile.inf(位于 C: 驱动器上的 infpath 中)添加打印机,请键入:

rundll32 printui.dll PrintUIEntry /ii /f c:\Infpath\InfFile.inf

若要删除计算机 Client1 上的现有打印机 printer1,请键入:

rundll32 printui.dll PrintUIEntry /dn /n\\client1\printer1

若要添加单台计算机的打印机连接 printer2,对于计算机 Client2 的所有用户,请键入(用户登录时将应用该连接):

rundll32 printui.dll PrintUIEntry /ga /n\\client2\printer2

若要删除单台计算机的打印机连接 printer2,对于计算机 Client2 的所有用户,请键入(用户登录时将删除该连接):

rundll32 printui.dll PrintUIEntry /gd /n\\client2\printer2

若要查看打印服务器 printServer1 的属性,请键入:

rundll32 printui.dll PrintUIEntry /s /t1 /c\\printserver1

若要查看打印机 printer3 的属性,请键入:

rundll32 printui.dll PrintUIEntry /p /n\\printer3