Module PowerShell d’impression universelle

Le module PowerShell UniversalPrintManagement est conçu pour gérer et administrer des ressources d’impression universelle à partir de la ligne de commande. Utilisez ce module lorsque vous souhaitez créer des outils automatisés.

Cet article vous aide à bien démarrer avec le module UniversalPrintManagement et enseigne les concepts fondamentaux derrière celui-ci.

Installation de UniversalPrintManagement

Exécutez la commande suivante à partir d’une session PowerShell :

Install-Module UniversalPrintManagement

Par défaut, la galerie PowerShell n’est pas configurée comme un référentiel de confiance pour PowerShellGet. La première fois que vous utilisez PSGallery, vous verrez l’invite suivante :

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"):

Répondez Yes ou Yes to All pour procéder à l’installation.

Remarque

Pour plus d’informations sur l’installation des modules PSGallery dans des scénarios hors connexion, reportez-vous à PowerShell Gallery.

Désinstallation de UniversalPrintManagement

Exécutez la commande suivante à partir d’une session PowerShell :

Uninstall-Module -Name UniversalPrintManagement

Se connecter à l’impression universelle

Connexion interactive avec la cmdlet Connect-UPService.

Connect-UPService

Vous obtiendrez une boîte de dialogue de connexion pour fournir un nom d’utilisateur et un mot de passe pour votre compte Azure ou sélectionner l’un des comptes précédemment enregistrés.

Remarque

L’objectif principal de cette applet de commande est d’autoriser la connexion non interactive pour les scripts automatisés. Cela peut être effectué, par exemple, à l’aide Connect-UPService -UserPrincipalName username@tenantname.com -Password $variableHoldingSecureString de la syntaxe et de la récupération du mot de passe à partir d’un stockage sécurisé.

Une fois connecté, utilisez les applets de commande disponibles dans le module pour accéder aux ressources d’imprimante et les gérer.

Applets de commande UniversalPrintManagement

Les applets de commande UniversalPrintManagement suivent une convention d’affectation de noms standard pour PowerShell. VERB-NOUN Le verbe décrit l’action (exemples includeGet, , SetGrant, Revoke, ) et le nom décrit le type de ressource (exemples include UPPrinter, UPPrintJob, UPAccess). Les noms dans UniversalPrintManagement commencent toujours par le préfixe UP.

Connaître les noms et les verbes vous aident à trouver des commandes avec l’applet de commande Get-Command . Par exemple, pour rechercher des commandes qui utilisent le Get verbe :

Get-Command -Verb Get -Module UniversalPrintManagement

Pour obtenir des détails sur l’applet de commande avec des exemples :

Get-Help Get-UPPrinter -Detailed

[REMARQUE] Les applets de commande UniversalPrintManagement Get retournent désormais des résultats avec des jetons de continuation pour permettre la pagination par le biais de collections volumineuses et la retying des requêtes ayant échoué. Découvrez comment utiliser des jetons de continuation. En raison du changement de modèle requis pour prendre en charge les jetons de continuation, il est désormais recommandé de stocker Get les résultats de l’applet de commande dans une variable et de les accéder via .results. Consultez les exemples ici.

Connexion

Applet de commande	Description
Connecter-UPService	Connecter avec un compte authentifié à utiliser pour les demandes d’applet de commande d’impression universelle.

Imprimantes

Applet de commande	Description
Get-UPPrinter	Utilisez cette applet de commande pour obtenir des informations sur une seule ou liste d’imprimantes.
Remove-UPPrinter	Utilisez cette applet de commande pour annuler l’inscription des imprimantes.

Propriétés de l’imprimante

Applet de commande	Description
Set-UPPrinterProperty	Utilisez cette applet de commande pour mettre à jour les propriétés mutables d’une imprimante.

Partages d’imprimantes

Applet de commande	Description
New-UPPrinterShare	Utilisez cette applet de commande pour partager une imprimante.
Get-UPPrinterShare	Utilisez cette applet de commande pour obtenir des informations sur une seule ou liste d’imprimantes partagées.
Remove-UPPrinterShare	Utilisez cette applet de commande pour annuler le partage d’imprimantes qui ont été partagées précédemment.
Set-UPPrinterShare	Utilisez cette applet de commande pour mettre à jour un partage d’imprimante pour échanger une imprimante inscrite en raison d’une maintenance avec une imprimante opérationnelle.

Autorisations utilisateur

Applet de commande	Description
Grant-UPAccess	Utilisez cette applet de commande pour accorder l’accès à l’impression à un utilisateur ou à un groupe ou à tous les utilisateurs de l’organisation.
Revoke-UPAccess	Utilisez cette applet de commande pour révoquer l’accès à l’impression d’un utilisateur ou d’un groupe ou de tous les utilisateurs de l’organisation.
Get-UPAllowedMember	Utilisez cette applet de commande pour obtenir des informations sur les utilisateurs et les groupes qui ont accès à une imprimante spécifique.

Connecteurs

Applet de commande	Description
Get-UP Connecter or	Utilisez cette applet de commande pour obtenir des informations sur une seule ou liste de connecteurs.
Remove-UP Connecter or	Utilisez cette applet de commande pour annuler l’inscription des connecteurs.

propriétés de Connecter or

Applet de commande	Description
Configurer Connecter orProperty	Utilisez cette applet de commande pour mettre à jour les propriétés mutables d’un connecteur.

Travaux d’impression

Applet de commande	Description
Get-UPPrintJob	Utilisez cette applet de commande pour obtenir des informations sur les travaux d’impression envoyés à une imprimante.

Imprimer des rapports de travaux

Applet de commande	Description
Get-UPUsageReport	Utilisez cette applet de commande pour obtenir différents types de rapports d’utilisation d’impression.