módulo do PowerShell para Impressão Universal

O módulo do PowerShell UniversalPrintManagementmodule foi projetado para gerenciar e administrar recursos do Impressão Universal por meio da linha de comando. Use este módulo quando quiser criar ferramentas automatizadas.

Este artigo ajuda você a começar a usar o módulo UniversalPrintManagement e ensina os principais conceitos por trás dele.

Instalação do UniversalPrintManagement

Execute o seguinte comando em uma sessão do PowerShell:

Install-Module UniversalPrintManagement

Por padrão, a galeria do PowerShell não está configurada como um repositório confiável para o PowerShellGet. Na primeira vez que usar o PSGallery, você 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 obter informações adicionais sobre como instalar módulos PSGallery em cenários offline, consulte o Galeria do PowerShell.

Desinstalando UniversalPrintManagement

Execute o seguinte comando em uma sessão do PowerShell:

Uninstall-Module -Name UniversalPrintManagement

Entrar no Impressão Universal

Faça login interativamente usando o cmdlet Connect-UPService.

Connect-UPService

Você obterá uma caixa de diálogo de entrada para fornecer um nome de usuário e senha para sua conta de Azure ou selecionar uma das contas salvas anteriormente.

Note

A principal finalidade desse cmdlet é permitir a entrada não interativa para scripts automatizados. Isso pode ser feito, por exemplo, usando Connect-UPService -UserPrincipalName username@tenantname.com -Password $variableHoldingSecureString a sintaxe e recuperando a senha de um armazenamento seguro.

Depois de conectado, use os cmdlets disponíveis no módulo para acessar e gerenciar 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 sempre começam com o prefixo UP.

Conhecer os substantivos e verbos ajuda você a encontrar comandos com o cmdlet Get-Command . Por exemplo, para localizar comandos que usam o verbo Get:

Get-Command -Verb Get -Module UniversalPrintManagement

Para obter detalhes do cmdlet com exemplos:

Get-Help Get-UPPrinter -Detailed

[OBSERVAÇÃO] Os cmdlets UniversalPrintManagement Get agora retornam resultados com tokens de continuação para permitir paginar grandes coleções e tentar novamente solicitações com falha. Saiba como usar tokens de continuação. Devido à alteração de modelo necessária para acomodar tokens de continuação, agora é recomendável armazenar os resultados do cmdlet Get em uma variável e acessá-los por meio de .results. Veja exemplos aqui.

Entrar

Cmdlet Description
Connect-UPService Conecta-se com uma conta autenticada a ser usada para solicitações de cmdlet Impressão Universal.

Printers

Cmdlet Description
Get-UPPrinter Use este cmdlet para obter informações sobre uma única ou lista de impressoras.
Remove-UPPrinter Use este cmdlet para cancelar o registro de impressoras.

Propriedades da impressora

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

Impressoras compartilhadas

Cmdlet Description
New-UPPrinterShare Use este cmdlet para compartilhar uma impressora.
Get-UPPrinterShare Use este cmdlet para obter informações sobre uma única ou lista de impressoras compartilhadas.
Remove-UPPrinterShare Use esse cmdlet para descompartilhar impressoras que foram compartilhadas anteriormente.
Set-UPPrinterShare Use este cmdlet para atualizar um compartilhamento de impressora para trocar uma impressora registrada devido à manutenção com uma em funcionamento.

Permissões de Usuário

Cmdlet Description
Grant-UPAccess Use este cmdlet para conceder acesso de impressão a um usuário ou grupo ou a todos os usuários da organização.
Revoke-UPAccess Use esse cmdlet para revogar o acesso de impressão de um usuário ou grupo ou de todos os usuários da organização.
Get-UPAllowedMember Use este cmdlet para obter informações sobre usuários e grupos que têm acesso de impressão a uma impressora específica.

Connectors

Cmdlet Description
Get-UPConnector Use este cmdlet para obter informações sobre um único conector ou uma lista de conectores.
Remove-UPConnector Use este cmdlet para cancelar o registro de conectores.

Propriedades do conector

Cmdlet Description
ConfigurarPropriedadeConector Use este cmdlet para atualizar as 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 para uma impressora.
Cmdlet Description
Get-UPUsageReport Use este cmdlet para obter diferentes tipos de relatórios de uso de impressão.
  • Last updated on