Módulo do PowerShell do Impressão Universal

O módulo PowerShell UniversalPrintManagement foi concebido para gerir e administrar os recursos do Impressão Universal a partir da linha de comandos. Use este módulo quando quiser construir ferramentas automatizadas.

Este artigo ajuda-o a começar com o módulo UniversalPrintManagement e ensina os conceitos fundamentais por trás do mesmo.

Instalação do UniversalPrintManagement

Execute o seguinte comando a partir de uma sessão PowerShell:

Install-Module UniversalPrintManagement

Por predefinição, a galeria do PowerShell não está configurada como um repositório fidedigno para o PowerShellGet. Na primeira vez que usar o PSGallery verá o seguinte prompt:

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

Responda Yes ou Yes to All para continuar com a instalação.

Note

Para informações adicionais sobre a instalação de módulos PSGallery em cenários offline, consulte o Galeria do PowerShell.

Desinstalar o UniversalPrintManagement

Execute o seguinte comando a partir de uma sessão PowerShell:

Uninstall-Module -Name UniversalPrintManagement

Iniciar sessão na Impressão Universal

Inicia sessão interativamente com o Connect-UPService cmdlet.

Connect-UPService

Receberá uma janela de entrada para fornecer um nome de utilizador e palavra-passe para a sua conta Azure ou selecionar uma das contas anteriormente guardadas.

Note

O principal objetivo deste cmdlet é permitir o início de sessão sem interação para scripts automatizados. Isto pode ser feito, por exemplo, usando Connect-UPService -UserPrincipalName username@tenantname.com -Password $variableHoldingSecureString sintaxe e recuperando a palavra-passe de um armazenamento seguro.

Depois de iniciar sessão, use os cmdlets disponíveis no módulo para aceder e gerir os recursos da impressora.

UniversalPrintManagement Cmdlets

Os cmdlets UniversalPrintManagement seguem uma convenção de nomenclatura padrão para o PowerShell, VERB-NOUN. O verbo descreve a ação (exemplos incluem Get, Set, Grant, Revoke) e o substantivo descreve o tipo de recurso (exemplos incluem UPPrinter, UPPrintJob, UPAccess). Os substantivos no UniversalPrintManagement começam sempre com o prefixo UP.

Conhecer os substantivos e verbos ajuda-te a encontrar comandos com o comando Get-Command . Por exemplo, para encontrar comandos que usam o verbo Get :

Get-Command -Verb Get -Module UniversalPrintManagement

Para obter detalhes do cmdlet com exemplos:

Get-Help Get-UPPrinter -Detailed

[NOTA] Os cmdlets UniversalPrintManagement Get devolvem agora resultados com tokens de continuação para permitir a paginação de grandes coleções e a repetição de pedidos que falharam. Aprenda a usar tokens de continuação. Devido à alteração do modelo necessária para acomodar os tokens de continuação, passa agora a ser recomendável armazenar os resultados do cmdlet Get numa variável e aceder-lhes através de .results. Veja exemplos aqui.

Sign-in

Cmdlet Description
Connect-UPService Liga-se a uma conta autenticada para a utilizar nos pedidos aos cmdlets do Impressão Universal.

Printers

Cmdlet Description
Get-UPPrinter Use este cmdlet para obter informações sobre uma ou lista de impressoras.
Remove-UPPrinter Use este cmdlet para desregistar impressoras.

Propriedades da Impressora

Cmdlet Description
Set-UPPrinterProperty Use este cmdlet para atualizar propriedades mutáveis de uma impressora.

Partilhas de Impressoras

Cmdlet Description
Novo-UPPrinterShare Use este cmdlet para partilhar uma impressora.
Get-UPPrinterShare Use este cmdlet para obter informações sobre uma impressora partilhada ou uma lista.
Remove-UPPrinterShare Utilize este cmdlet para anular a partilha de impressoras que tenham sido partilhadas anteriormente.
Set-UPPrinterShare Usa este cmdlet para atualizar uma partilha de impressora e trocar uma impressora registada em espera de manutenção por uma que funcione.

Permissões do Usuário

Cmdlet Description
Grant-UPAccess Use este cmdlet para conceder acesso impresso a um utilizador, grupo ou a todos os utilizadores da organização.
Revoke-UPAccess Use este comando para revogar o acesso impresso a um utilizador, grupo ou a todos os utilizadores da organização.
Get-UPAllowedMember Use este cmdlet para obter informações sobre utilizadores e grupos que têm acesso impresso a uma impressora específica.

Conectores

Cmdlet Description
Get-UPConnector Use este cmdlet para obter informações sobre um ou uma lista de conectores.
Remove-UPConnector Use este cmdlet para desregistar conectores.

Propriedades do Conector

Cmdlet Description
Set-UPConnectorProperty Use este cmdlet para atualizar propriedades mutáveis de um conector.
Cmdlet Description
Get-UPPrintJob Use este cmdlet para obter informações sobre trabalhos de impressão que foram enviados a uma gráfica.
Cmdlet Description
Get-UPUsageReport Use este cmdlet para obter diferentes tipos de relatórios de utilização impressa.
  • Last updated on