Partager via

Module PowerShell d’impression universelle

  • Article

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.
Applet de commande Description
Get-UPPrintJob Utilisez cette applet de commande pour obtenir des informations sur les travaux d’impression envoyés à une imprimante.
Applet de commande Description
Get-UPUsageReport Utilisez cette applet de commande pour obtenir différents types de rapports d’utilisation d’impression.