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 の標準的な名前付け規則に従います。 動詞はアクション (例: Get、 Set、 Grant、 Revoke) を記述し、名詞はリソースの種類 (例: UPPrinter、 UPPrintJob、 UPAccess) を記述します。 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 | このコマンドレットを使用して、さまざまな種類の印刷使用状況レポートを取得します。 |