ユニバーサル プリント PowerShell モジュール

UniversalPrintManagement PowerShell module は、コマンド ラインからユニバーサル プリントリソースを管理および管理するために設計されています。 自動ツールを構築する場合は、このモジュールを使用します。

この記事では、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に応答して、インストールを続行します。

Note

オフライン シナリオでの PSGallery モジュールのインストールの詳細については、PowerShell ギャラリーを参照してください。

UniversalPrintManagement のアンインストール

PowerShell セッションから次のコマンドを実行します。

Uninstall-Module -Name UniversalPrintManagement

ユニバーサル プリントにサインインする

Connect-UPService コマンドレットを使用して対話形式でサインインします。

Connect-UPService

サインイン ダイアログが表示され、Azure アカウントのユーザー名とパスワードを指定するか、以前に保存したアカウントのいずれかを選択できます。

Note

このコマンドレットの主な目的は、自動スクリプトの非対話型サインインを許可することです。 これを行うには、たとえば、 Connect-UPService -UserPrincipalName username@tenantname.com -Password $variableHoldingSecureString 構文を使用し、セキュリティで保護されたストレージからパスワードを取得します。

サインインしたら、モジュールで使用可能なコマンドレットを使用して、プリンター リソースにアクセスして管理します。

ユニバーサル プリント管理コマンドレット

UniversalPrintManagement コマンドレットは、 VERB-NOUN PowerShell の標準的な名前付け規則に従います。 動詞はアクション (例: GetSetGrantRevoke) を記述し、名詞はリソースの種類 (例: UPPrinterUPPrintJobUPAccess) を記述します。 UniversalPrintManagement の名詞は、常にプレフィックス UPで始まります。

名詞と動詞を知ることは、 Get-Command コマンドレットを使用してコマンドを見つけるのに役立ちます。 たとえば、 Get 動詞を使用するコマンドを検索するには、次のようにします。

Get-Command -Verb Get -Module UniversalPrintManagement

例を使用してコマンドレットの詳細を取得するには:

Get-Help Get-UPPrinter -Detailed

[注]UniversalPrintManagement Get コマンドレットは、大規模なコレクションをページングし、失敗した要求を再要求できるように、継続トークンを使用して結果を返すようになりました。 継続トークンを使用する方法について説明します。 継続トークンに対応するために必要なモデルの変更により、コマンドレットの結果 Get 変数に格納し、 .results経由でアクセスすることをお勧めします。 例については、こちらをご覧ください。

サインイン

コマンドレット Description
Connect-UPService ユニバーサル プリントコマンドレット要求に使用する認証済みアカウントに接続します。

Printers

コマンドレット Description
Get-UPPrinter このコマンドレットを使用して、プリンターの 1 つまたは一覧に関する情報を取得します。
Remove-UPPrinter プリンターの登録を解除するには、このコマンドレットを使用します。

プリンターのプロパティ

コマンドレット Description
Set-UPPrinterProperty プリンターの変更可能なプロパティを更新するには、このコマンドレットを使用します。

プリンター共有

コマンドレット Description
New-UPPrinterShare プリンターを共有するには、このコマンドレットを使用します。
Get-UPPrinterShare このコマンドレットを使用して、共有プリンターの 1 つまたは一覧に関する情報を取得します。
Remove-UPPrinterShare このコマンドレットを使用して、以前に共有されているプリンターの共有を解除します。
プリンター共有の設定 このコマンドレットを使用して、プリンター共有を更新し、メンテナンスのために登録済みのプリンターを作業用プリンターと交換します。

ユーザーのアクセス許可

コマンドレット Description
Grant-UPAccess このコマンドレットを使用して、ユーザーまたはグループ、または組織内のすべてのユーザーに印刷アクセス権を付与します。
Revoke-UPAccess このコマンドレットを使用して、組織内のユーザーまたはグループまたはすべてのユーザーからの印刷アクセスを取り消します。
Get-UPAllowedMember このコマンドレットを使用して、特定のプリンターへの印刷アクセス権を持つユーザーとグループに関する情報を取得します。

コネクタ

コマンドレット Description
Get-UPConnector このコマンドレットを使用して、コネクタの 1 つまたは一覧に関する情報を取得します。
UPConnector を削除 コネクタの登録を解除するには、このコマンドレットを使用します。

コネクタのプロパティ

コマンドレット Description
Set-UPConnectorProperty コネクタの変更可能なプロパティを更新するには、このコマンドレットを使用します。
コマンドレット Description
Get-UPPrintJob このコマンドレットを使用して、プリンターに送信された印刷ジョブに関する情報を取得します。
コマンドレット Description
Get-UPUsageReport このコマンドレットを使用して、さまざまな種類の印刷使用状況レポートを取得します。