Modulo PowerShell di Stampa universale

Il UniversalPrintManagement PowerShell module è progettato per la gestione e l'amministrazione delle risorse 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"):

Rispondi Yes o Yes to All per continuare con l'installazione.

Nota

Per altre informazioni sull'installazione dei 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 Connect-UPService cmdlet .

Connect-UPService

Si otterrà una finestra di dialogo di accesso per fornire 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 di UniversalPrintManagement

I cmdlet UniversalPrintManagement seguono una convenzione di denominazione standard per PowerShell, VERB-NOUN. Il verbo descrive l'azione (esempi includono , Get, , Set) e il sostantivo descrive il tipo di risorsa (esempi includono GrantRevoke, UPPrinter). UPPrintJobUPAccess 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 di scorrere raccolte di grandi dimensioni e di ritentare le 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.

Sign-in

Cmdlet Description
Connect-UPService Si connette a un account autenticato da utilizzare per le richieste dei cmdlet di Stampa universale.

Printers

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

Proprietà stampante

Cmdlet Description
Imposta proprietà stampante Utilizzare questo cmdlet per aggiornare le proprietà modificabili di una stampante.

Condivisioni di stampanti

Cmdlet Description
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 Description
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 Description
Get-UPConnector Usare questo cmdlet per ottenere informazioni su un singolo o elenco di connettori.
Rimuovi UPConnector Usare questo cmdlet per annullare la registrazione dei connettori.

Proprietà del connettore

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