Condividi tramite

Modulo Di PowerShell di stampa universale

  • Articolo

Il modulo PowerShell UniversalPrintManagement è progettato per la gestione e l'amministrazione delle risorse di stampa universale dalla riga di comando. Usare questo modulo quando si vogliono creare strumenti automatizzati.

Questo articolo illustra come iniziare a usare il modulo UniversalPrintManagement e illustra i concetti di base alla base.

Installazione di UniversalPrintManagement

Eseguire il comando seguente da una sessione di PowerShell:

Install-Module UniversalPrintManagement

Per impostazione predefinita, PowerShell Gallery non è configurata come archivio attendibile per PowerShellGet. La prima volta che si usa PSGallery, verrà visualizzato il prompt seguente:

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

Rispondere Yes o Yes to All per continuare l'installazione.

Nota

Per altre informazioni sull'installazione di moduli PSGallery in scenari offline, vedere PowerShell Gallery.

Disinstallazione di UniversalPrintManagement

Eseguire il comando seguente da una sessione di PowerShell:

Uninstall-Module -Name UniversalPrintManagement

Accedere a Stampa universale

Accedere in modo interattivo con il cmdlet Connect-UPService.

Connect-UPService

Si otterrà una finestra di dialogo di accesso per specificare un nome utente e una password per l'account Azure o selezionare uno degli account salvati in precedenza.

Nota

Lo scopo principale di questo cmdlet è consentire l'accesso non interattivo per gli script automatizzati. Questa operazione può essere eseguita, ad esempio, usando Connect-UPService -UserPrincipalName username@tenantname.com -Password $variableHoldingSecureString la sintassi e recuperando la password da una risorsa di archiviazione sicura.

Dopo l'accesso, usare i cmdlet disponibili nel modulo per accedere e gestire le risorse della stampante.

Cmdlet UniversalPrintManagement

I cmdlet UniversalPrintManagement seguono una convenzione di denominazione standard per PowerShell, VERB-NOUN. Il verbo descrive l'azione (esempi includono , Set, , Revoke) e il sostantivo descrive il tipo di risorsa (esempi includono GetUPPrinter, UPPrintJob). UPAccessGrant I sostantivi in UniversalPrintManagement iniziano sempre con il prefisso UP.

Conoscere i sostantivi e i verbi consente di trovare i comandi con il cmdlet Get-Command . Ad esempio, per trovare i comandi che usano il Get verbo :

Get-Command -Verb Get -Module UniversalPrintManagement

Per ottenere i dettagli dei cmdlet con esempi:

Get-Help Get-UPPrinter -Detailed

[NOTA] I cmdlet UniversalPrintManagement Get restituiscono ora risultati con token di continuazione per consentire il paging tramite raccolte di grandi dimensioni e la ripetizione di richieste non riuscite. Informazioni su come usare i token di continuazione. A causa della modifica del modello necessaria per supportare i token di continuazione, è ora consigliabile archiviare Get i risultati dei cmdlet in una variabile e accedervi tramite .results. Vedere gli esempi qui.

Accedi

Cmdlet Descrizione
Connessione-UPService Connessione con un account autenticato da usare per le richieste dei cmdlet universali di stampa.

Printers

Cmdlet Descrizione
Get-UPPrinter Utilizzare questo cmdlet per ottenere informazioni su un singolo o elenco di stampanti.
Remove-UPPrinter Utilizzare questo cmdlet per annullare la registrazione delle stampanti.

Proprietà stampante

Cmdlet Descrizione
Set-UPPrinterProperty Utilizzare questo cmdlet per aggiornare le proprietà modificabili di una stampante.

Condivisioni stampanti

Cmdlet Descrizione
New-UPPrinterShare Utilizzare questo cmdlet per condividere una stampante.
Get-UPPrinterShare Usare questo cmdlet per ottenere informazioni su un singolo o elenco di stampanti condivise.
Remove-UPPrinterShare Usare questo cmdlet per annullare la condivisione delle stampanti condivise in precedenza.
Set-UPPrinterShare Utilizzare questo cmdlet per aggiornare una condivisione della stampante per scambiare una stampante registrata a causa della manutenzione con una stampante funzionante.

Autorizzazioni utente

Cmdlet Descrizione
Grant-UPAccess Usare questo cmdlet per concedere l'accesso di stampa a un utente o a un gruppo o a tutti gli utenti dell'organizzazione.
Revoke-UPAccess Usare questo cmdlet per revocare l'accesso di stampa a un utente o a un gruppo o a tutti gli utenti dell'organizzazione.
Get-UPAllowedMember Utilizzare questo cmdlet per ottenere informazioni su utenti e gruppi che dispongono dell'accesso di stampa a una stampante specifica.

Connettori

Cmdlet Descrizione
Get-UP Connessione or Usare questo cmdlet per ottenere informazioni su un singolo o elenco di connettori.
Remove-UP Connessione or Usare questo cmdlet per annullare la registrazione dei connettori.

Proprietà Connessione or

Cmdlet Descrizione
Set-UP Connessione orProperty Usare questo cmdlet per aggiornare le proprietà modificabili di un connettore.
Cmdlet Descrizione
Get-UPPrintJob Utilizzare questo cmdlet per ottenere informazioni sui processi di stampa inviati a una stampante.
Cmdlet Descrizione
Get-UPUsageReport Usare questo cmdlet per ottenere diversi tipi di report sull'utilizzo di stampa.