Partilhar via


Módulo Universal Print PowerShell

O módulo PowerShell UniversalPrintManagementfoi 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 com o módulo UniversalPrintManagement e ensina os principais conceitos por trás dele.

Instalando o UniversalPrintManagement

Execute o seguinte comando a partir de uma sessão do 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 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 com a instalação.

Nota

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 a partir de uma sessão do PowerShell:

Uninstall-Module -Name UniversalPrintManagement

Iniciar sessão no Universal Print

Inicie sessão 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.

Nota

O principal objetivo desse cmdlet é permitir o login não interativo 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 entrar, use os cmdlets disponíveis no módulo para acessar e gerenciar 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 , , , Revoke) e o substantivo descreve o tipo de recurso (exemplos incluem UPPrinterGet, , UPAccessSetGrantUPPrintJob). Os substantivos em 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 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 os resultados do cmdlet em uma variável e acessá-los via .results. Veja exemplos aqui.

Iniciar sessão

Cmdlet Description
Connect-UPService Conecta-se a uma conta autenticada para usar em solicitações de cmdlet do Universal Print.

Impressoras

Cmdlet Description
Get-UPPrinter Use este cmdlet para obter informações sobre uma única impressora ou uma lista de impressoras.
Remover-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.

Compartilhamentos de impressora

Cmdlet Description
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.
Remove-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 Utilizador

Cmdlet Description
Bolsa-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.
Revogação-UPAccess Use este 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.

Conectores

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

Propriedades do conector

Cmdlet Description
Set-UPConnectorProperty 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.