通用打印 PowerShell 模块

项目
10/18/2023

UniversalPrintManagement PowerShell 模块旨在从命令行管理和管理通用打印资源。若要生成自动化工具，请使用此模块。

本文可帮助你开始使用 UniversalPrintManagement 模块，并介绍其背后的核心概念。

安装 UniversalPrintManagement

从 PowerShell 会话运行以下命令：

Install-Module UniversalPrintManagement

默认情况下，PowerShell 库未配置为 PowerShellGet 的受信任存储库。首次使用 PSGallery 时，将看到以下提示：

Untrusted repository

You are installing the modules from an untrusted repository. If you trust this repository, change
its InstallationPolicy value by running the `Set-PSRepository` cmdlet.

Are you sure you want to install the modules from 'PSGallery'?
[Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend  [?] Help (default is "N"):

请回答 Yes 或 Yes to All 继续安装。

注意

有关在脱机方案中安装 PSGallery 模块的其他信息，请参阅PowerShell 库。

卸载 UniversalPrintManagement

从 PowerShell 会话运行以下命令：

Uninstall-Module -Name UniversalPrintManagement

使用 Connect-UPService cmdlet 以交互方式登录。

Connect-UPService

你将获得一个登录对话框，用于为 Azure 帐户提供用户名和密码，或选择其中一个以前保存的帐户。

注意

此 cmdlet 的主要用途是允许自动脚本的非交互式登录。例如， Connect-UPService -UserPrincipalName username@tenantname.com -Password $variableHoldingSecureString 可以使用语法并从安全存储检索密码来完成此操作。

登录后，使用模块中的可用 cmdlet 访问和管理打印机资源。

UniversalPrintManagement Cmdlet

UniversalPrintManagement cmdlet 遵循 PowerShell VERB-NOUN的标准命名约定。谓词描述操作（示例包括Get，，Set，GrantRevoke）和名词描述资源类型（示例包括UPPrinter，，UPPrintJob， UPAccess）。 UniversalPrintManagement 中的名词始终以前缀 UP开头。

了解名词和谓词有助于使用 Get-Command cmdlet 查找命令。例如，若要查找使用谓词的 Get 命令：

Get-Command -Verb Get -Module UniversalPrintManagement

若要获取包含示例的 cmdlet 详细信息，请参阅：

Get-Help Get-UPPrinter -Detailed

[注意]UniversalPrintManagement Get cmdlet 现在返回带有继续标记的结果，以允许通过大型集合分页并重新设置失败的请求。了解如何使用延续令牌。由于需要模型更改以适应延续令牌，因此现在建议将 cmdlet 结果存储在 Get 变量中，并通过该 .results变量访问它们。请参阅此处的示例。

Cmdlet	说明
连接-UPService	使用经过身份验证的帐户连接用于通用打印 cmdlet 请求。

打印机

Cmdlet	说明
Get-UPPrinter	使用此 cmdlet 获取有关单个打印机或打印机列表的信息。
Remove-UPPrinter	使用此 cmdlet 取消注册打印机。

打印机属性

Cmdlet	说明
Set-UPPrinterProperty	使用此 cmdlet 更新打印机的可变属性。

打印机共享

Cmdlet	说明
New-UPPrinterShare	使用此 cmdlet 共享打印机。
Get-UPPrinterShare	使用此 cmdlet 获取有关单个或共享打印机列表的信息。
Remove-UPPrinterShare	使用此 cmdlet 取消共享之前共享的打印机。
Set-UPPrinterShare	使用此 cmdlet 更新打印机共享，以交换已注册的打印机，因为维护与工作打印机。

用户权限

Cmdlet	说明
Grant-UPAccess	使用此 cmdlet 授予对组织中的用户或组或所有用户的打印访问权限。
Revoke-UPAccess	使用此 cmdlet 可撤销组织中用户或组或所有用户的打印访问权限。
Get-UPAllowedMember	使用此 cmdlet 获取对特定打印机具有打印访问权限的用户和组的信息。

连接器

Cmdlet	说明
Get-UP连接or	使用此 cmdlet 获取有关单个或连接器列表的信息。
Remove-UP连接or	使用此 cmdlet 取消注册连接器。

连接or 属性

Cmdlet	说明
Set-UP连接orProperty	使用此 cmdlet 更新连接器的可变属性。

打印作业

Cmdlet	说明
Get-UPPrintJob	使用此 cmdlet 获取有关发送到打印机的打印作业的信息。

打印作业报告

Cmdlet	说明
Get-UPUsageReport	使用此 cmdlet 获取不同类型的打印使用情况报告。

通过