Compartilhar via

Módulo PowerShell de Impressão Universal

  • Artigo

O módulo do PowerShell UniversalPrintManagement foi projetado para gerenciar e administrar recursos do Universal Print a partir 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.

Instalando o 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 você 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 a instalação.

Observação

Para obter informações adicionais sobre como instalar módulos PSGallery em cenários offline, consulte a Galeria do PowerShell.

Desinstalando o UniversalPrintManagement

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

Uninstall-Module -Name UniversalPrintManagement

Entrar no Universal Print

Entre interativamente com o cmdlet Connect-UPService.

Connect-UPService

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

Observação

O principal objetivo 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 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 PowerShell, VERB-NOUN. O verbo descreve a ação (exemplos incluem , , , ) e o substantivo descreve o tipo de recurso (exemplos incluem UPPrinterGet, , UPAccessUPPrintJobSetGrant). Revoke Os substantivos em UniversalPrintManagement sempre começam com o prefixo UP.

Conhecer os substantivos e verbos ajuda a localizar 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

[NOTA] Os cmdlets UniversalPrintManagement Get agora retornam resultados com tokens de continuação para permitir a paginação por meio de grandes coleções e a revinculação de 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 Get resultados de cmdlet em uma variável e acessá-los via .results. Veja exemplos aqui.

Conexão

Cmdlet Descrição
Conectar-UPService Conecta-se a uma conta autenticada a ser usada para solicitações de cmdlet Universal Print.

Impressoras

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

Propriedades da impressora

Cmdlet Descrição
Set-UPPrinterProperty Use este cmdlet para atualizar as propriedades mutáveis de uma impressora.

Compartilhamentos de impressora

Cmdlet Descrição
Novo-UPPrinterShare Use este cmdlet para compartilhar uma impressora.
Get-UPPrinterShare Use este cmdlet para obter informações sobre uma única impressora ou uma lista de impressoras compartilhadas.
Remover-UPPrinterShare Use este cmdlet para cancelar o compartilhamento de impressoras que foram compartilhadas anteriormente.
Set-UPPrinterShare Use este cmdlet para atualizar um compartilhamento de impressora para trocar uma impressora registrada que deve ser mantida por uma em funcionamento.

Permissões de Usuário

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

Conectores

Cmdlet Descrição
Get-UPConnector Use este cmdlet para obter informações sobre um único ou lista de conectores.
Remover-UPConnector Use este cmdlet para cancelar o registro de conectores.

Propriedades do conector

Cmdlet Descrição
Set-UPConnectorPropriedade Use este cmdlet para atualizar as propriedades mutáveis de um conector.
Cmdlet Descrição
Get-UPPrintJob Use esse cmdlet para obter informações sobre trabalhos de impressão que foram enviados a uma impressora.
Cmdlet Descrição
Get-UPUsageReport Use esse cmdlet para obter diferentes tipos de relatórios de uso de impressão.