共用方式為

通用列印 PowerShell 模組

  • 發行項

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、 SetGrant、 Revoke和 名詞描述資源類型 （範例包括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加以存取。 請參閱這裡的範例。

登入

指令程式 描述
連線-UPService 使用已驗證的帳戶 連線，以用於通用列印 Cmdlet 要求。

印表機

指令程式 描述
Get-UPPrinter 使用此 Cmdlet 來取得單一或印表機清單的相關信息。
Remove-UPPrinter 使用此 Cmdlet 取消註冊印表機。

印表機屬性

指令程式 描述
Set-UPPrinterProperty 使用此 Cmdlet 來更新印表機的可變動屬性。

印表機共用

指令程式 描述
New-UPPrinterShare 使用此 Cmdlet 來共用印表機。
Get-UPPrinterShare 使用此 Cmdlet 來取得單一或共用印表機清單的相關信息。
Remove-UPPrinterShare 使用此 Cmdlet 取消共用先前共用的印表機。
Set-UPPrinterShare 使用此 Cmdlet 來更新印表機共用，以交換已註冊的印表機，因為維護與正常運作的印表機。

使用者權限

指令程式 描述
Grant-UPAccess 使用此 Cmdlet 將列印存取權授與使用者或群組或組織中的所有使用者。
Revoke-UPAccess 使用此 Cmdlet 撤銷組織中使用者或群組或所有使用者的列印存取權。
Get-UPAllowedMember 使用此 Cmdlet 取得可存取特定印表機之使用者和群組的相關信息。

連接器

指令程式 描述
Get-UP 連線 or 使用此 Cmdlet 來取得單一或連接器清單的相關信息。
Remove-UP 連線 or 使用此 Cmdlet 來取消註冊連接器。

連線 or 屬性

指令程式 描述
Set-UP 連線 orProperty 使用此 Cmdlet 來更新連接器的可變動屬性。
指令程式 描述
Get-UPPrintJob 使用此 Cmdlet 取得已傳送至印表機之列印作業的相關信息。
指令程式 描述
Get-UPUsageReport 使用此 Cmdlet 來取得不同類型的列印使用量報告。