module PowerShell pour Impression universelle

Le UniversalPrintManagement PowerShell module est conçu pour gérer et administrer des ressources 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 continuer l’installation.

Remarque

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

Désinstallation de UniversalPrintManagement

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

Uninstall-Module -Name UniversalPrintManagement

Connectez-vous à Impression universelle

Connectez-vous en mode interactif 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 renvoient désormais des résultats avec des jetons de reprise pour permettre la pagination dans de grandes collections et la nouvelle tentative des requêtes en échec. 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 des exemples ici.

Se connecter

Cmdlet Description
Connect-UPService Se connecte avec un compte authentifié à utiliser pour les demandes de cmdlet Impression universelle.

Printers

Cmdlet 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

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

Imprimantes partagées

Cmdlet 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

Cmdlet 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.

Connectors

Cmdlet Description
Get-UPConnector Utilisez cette applet de commande pour obtenir des informations sur une seule ou liste de connecteurs.
Supprimer-UPConnector Utilisez cette applet de commande pour annuler l’inscription des connecteurs.

Propriétés du connecteur

Cmdlet Description
ConfigurerPropriétéDuConnecteur Utilisez cette applet de commande pour mettre à jour les propriétés mutables d’un connecteur.
Cmdlet Description
Get-UPPrintJob Utilisez cette applet de commande pour obtenir des informations sur les travaux d’impression envoyés à une imprimante.
Cmdlet Description
Get-UPUsageReport Utilisez cette applet de commande pour obtenir différents types de rapports d’utilisation d’impression.
  • Last updated on