PowerShell からユニバーサル プリントを管理するには、次の 2 つのオプションがあります。
- UniversalPrintManagement モジュールを使用する: 一般的な管理タスクを最も簡単に実行できます。 コマンドを簡単に使用できますが、Microsoft Graph API で使用できる高度な機能の一部が不足している可能性があります。
- Microsoft Graph PowerShell SDK を使用する: Microsoft Graph API 全体を PowerShell でスクリプト実行できます。 コマンドは下位レベルであるため、単純なタスクのコマンドでも簡単に使用できない場合があります。
以下では、両方の方法について説明します。 例を切り替えると、主な違いを確認できます。
作業の開始
前提条件
- PowerShell 5.1 以降にアップグレードする
Install-Module PowerShellGet
を使用して、PowerShellGet を最新バージョンに更新するSet-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
を使用して、PowerShell スクリプト実行ポリシーをRemoteSigned
またはそれ以下の制限レベルに設定する必要があります。 制限レベルの詳細については、こちらを参照してください。
ステップ 1: PowerShell モジュールをインストールする
# To install for all users (must be administrator), remove -Scope CurrentUser
Install-Module UniversalPrintManagement -Scope CurrentUser
このコマンドは、要求されたモジュールを PowerShell ギャラリーから取得します。PowerShell ギャラリーは、既定では、PowerShellGet 用の信頼されたリポジトリとして構成されていません。 そのため、このコマンドを初めて実行すると、次のメッセージが表示される場合があります。
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
を選択します。
ステップ 2: ユニバーサル プリントに接続する
モジュールがインストールされたので、コマンドを実行する前にユニバーサル プリントに接続する必要があります。
# To provide authentication details interactively using a system authentication prompt:
Connect-UPService
# To provide authentication details non-interactively:
# Connect-UPService -UserPrincipalName username@tenantname.com -Password $variableHoldingSecureString
- 対象となるユニバーサル プリント ライセンスがあり、適切な管理者ロールが割り当てられている Microsoft Entra ID アカウントを使用して認証します。
- サインインした後、使用可能なコマンドレットを使用して、ユニバーサル プリントにアクセスして管理します。
ステップ 3: プリンターの一覧を取得して構成を確認する
すべてが正しく設定されていることを確認するには、テナントに登録されているプリンターの一覧を取得してみてください。 使用可能なコマンドの完全な一覧については、「コマンド リファレンス」を参照してください。
Get-UPPrinter
更新またはアンインストール
PowerShell モジュールを更新する
Update-Module UniversalPrintManagement
PowerShell モジュールをアンインストールする
後でモジュールのアンインストールが必要になった場合、次のコマンドを使用します。
Uninstall-Module -Name UniversalPrintManagement