ユニバーサル印刷 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 を選択します。
Note
オフライン シナリオでの PSGallery モジュールのインストールの詳細については、PowerShell ギャラリーを参照してください。
UniversalPrintManagement のアンインストール
PowerShell セッションから次のコマンドを実行します。
Uninstall-Module -Name UniversalPrintManagement
ユニバーサル印刷にサインインする
Connect-UPService コマンドレットを使って対話形式でサインインします。
Connect-UPService
サインイン ダイアログが表示され、Azure アカウントのユーザー名とパスワードを指定するか、以前に保存したアカウントのいずれかを選択します。
Note
このコマンドレットの主な目的は、自動スクリプトの非対話型サインインを許可することです。 これは、たとえば、構文を使用し Connect-UPService -UserPrincipalName username@tenantname.com -Password $variableHoldingSecureString 、セキュリティで保護されたストレージからパスワードを取得する場合などに実行できます。
サインインしたら、モジュールで使用可能なコマンドレットを使用して、プリンター リソースにアクセスして管理します。
UniversalPrintManagement コマンドレット
UniversalPrintManagement コマンドレットは、 VERB-NOUNPowerShell の標準的な名前付け規則に従います。 動詞はアクション (例: Get, , Set, Grant) を記述し、Revoke名詞はリソースの種類 (例: UPPrinter, , UPPrintJobUPAccess) を記述します。 UniversalPrintManagement の名詞は常にプレフィックス UPで始まります。
名詞と動詞を知ることは、 Get-Command コマンドレットを使用してコマンドを見つけるのに役立ちます。 たとえば、動詞を使用するコマンドを検索するには、次のようにします Get 。
Get-Command -Verb Get -Module UniversalPrintManagement
例を使用してコマンドレットの詳細を取得するには:
Get-Help Get-UPPrinter -Detailed
[注]UniversalPrintManagement
Getコマンドレットは継続トークンを使用して結果を返すようになり、大規模なコレクションをページングしたり、失敗した要求を再処理したりできるようになりました。 継続トークンを使用する方法について説明します。 継続トークンに対応するために必要なモデルの変更により、コマンドレットの結果を変数に格納Getし、それらを使用して.resultsアクセスすることをお勧めします。 例については、こちらを参照してください。
サインイン
| コマンドレット | 説明 |
|---|---|
| Connect-UPService | ユニバーサル印刷コマンドレット要求に使用する認証済みアカウントに接続します。 |
プリンター
| コマンドレット | 説明 |
|---|---|
| Get-UPPrinter | このコマンドレットを使用して、1 つまたは一覧のプリンターに関する情報を取得します。 |
| Remove-UPPrinter | プリンターの登録を解除するには、このコマンドレットを使用します。 |
プリンターのプロパティ
| コマンドレット | 説明 |
|---|---|
| Set-UPPrinterProperty | プリンターの変更可能なプロパティを更新するには、このコマンドレットを使用します。 |
プリンター共有
| コマンドレット | 説明 |
|---|---|
| New-UPPrinterShare | プリンターを共有するには、このコマンドレットを使用します。 |
| Get-UPPrinterShare | このコマンドレットを使用して、共有プリンターの単一または一覧に関する情報を取得します。 |
| Remove-UPPrinterShare | このコマンドレットを使用して、以前に共有されたプリンターの共有を解除します。 |
| Set-UPPrinterShare | このコマンドレットを使用して、プリンター共有を更新して、作業中のプリンターとのメンテナンスのために登録済みのプリンターを交換します。 |
ユーザーのアクセス許可
| コマンドレット | 説明 |
|---|---|
| Grant-UPAccess | このコマンドレットを使用して、ユーザーまたはグループ、または組織内のすべてのユーザーに印刷アクセス権を付与します。 |
| Revoke-UPAccess | このコマンドレットを使用して、ユーザーまたはグループ、または組織内のすべてのユーザーから印刷アクセスを取り消します。 |
| Get-UPAllowedMember | このコマンドレットを使用して、特定のプリンターへの印刷アクセス権を持つユーザーとグループに関する情報を取得します。 |
Connectors
| コマンドレット | 説明 |
|---|---|
| Get-UPConnector | このコマンドレットを使用して、コネクタの単一または一覧に関する情報を取得します。 |
| Remove-UPConnector | コネクタの登録を解除するには、このコマンドレットを使用します。 |
コネクタのプロパティ
| コマンドレット | 説明 |
|---|---|
| Set-UPConnectorProperty | コネクタの変更可能なプロパティを更新するには、このコマンドレットを使用します。 |
印刷ジョブ
| コマンドレット | 説明 |
|---|---|
| Get-UPPrintJob | プリンターに送信された印刷ジョブに関する情報を取得するには、このコマンドレットを使用します。 |
ジョブ レポートの印刷
| コマンドレット | 説明 |
|---|---|
| Get-UPUsageReport | このコマンドレットを使用して、さまざまな種類の印刷使用状況レポートを取得します。 |