Compartir a través de

Módulo de PowerShell de impresión universal

  • Artículo

El módulo universalPrintManagement de PowerShell está diseñado para administrar y administrar recursos de impresión universal desde la línea de comandos. Use este módulo cuando quiera crear herramientas automatizadas.

Este artículo le ayuda a empezar a trabajar con el módulo UniversalPrintManagement y enseña los conceptos básicos subyacentes.

Instalación de UniversalPrintManagement

Ejecute el siguiente comando desde una sesión de PowerShell:

Install-Module UniversalPrintManagement

De forma predeterminada, la Galería de PowerShell no está configurada como un repositorio de confianza para PowerShellGet. La primera vez que use PSGallery verá el siguiente símbolo del sistema:

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 o Yes to All para continuar con la instalación.

Nota:

Para obtener información adicional sobre cómo instalar módulos PSGallery en escenarios sin conexión, consulte el Galería de PowerShell.

Desinstalación de UniversalPrintManagement

Ejecute el siguiente comando desde una sesión de PowerShell:

Uninstall-Module -Name UniversalPrintManagement

Iniciar sesión en impresión universal

Inicie sesión de forma interactiva con el cmdlet Connect-UPService.

Connect-UPService

Obtendrá un cuadro de diálogo de inicio de sesión para proporcionar un nombre de usuario y una contraseña para su cuenta de Azure o seleccionar una de las cuentas guardadas anteriormente.

Nota:

El propósito principal de este cmdlet es permitir el inicio de sesión no interactivo para scripts automatizados. Esto se puede hacer, por ejemplo, mediante Connect-UPService -UserPrincipalName username@tenantname.com -Password $variableHoldingSecureString la sintaxis y la recuperación de la contraseña de un almacenamiento seguro.

Una vez que haya iniciado sesión, use los cmdlets disponibles en el módulo para acceder a los recursos de impresora y administrarlos.

UniversalPrintManagement Cmdlets

Los cmdlets universalPrintManagement siguen una convención de nomenclatura estándar para PowerShell, VERB-NOUN. El verbo describe la acción (ejemplos incluyen Get, Set, Grant, Revoke) y el nombre describe el tipo de recurso (ejemplos incluyen UPPrinter, UPPrintJob, UPAccess). Los nombres de UniversalPrintManagement siempre comienzan con el prefijo UP.

Conocer los nombres y verbos le ayudarán a encontrar comandos con el cmdlet Get-Command . Por ejemplo, para buscar comandos que usan el Get verbo:

Get-Command -Verb Get -Module UniversalPrintManagement

Para obtener detalles del cmdlet con ejemplos:

Get-Help Get-UPPrinter -Detailed

[NOTA] Los cmdlets UniversalPrintManagement Get ahora devuelven resultados con tokens de continuación para permitir la paginación a través de colecciones grandes y volver a establecer solicitudes con errores. Aprenda a usar tokens de continuación. Debido al cambio de modelo necesario para dar cabida a los tokens de continuación, ahora se recomienda almacenar Get los resultados del cmdlet en una variable y acceder a ellos a través de .results. Puede consultar ejemplos aquí.

Inicio de sesión

Cmdlet Descripción
Conectar-UPService Conectar con una cuenta autenticada que se usará para las solicitudes de cmdlet de impresión universal.

Impresoras

Cmdlet Descripción
Get-UPPrinter Use este cmdlet para obtener información sobre una sola o lista de impresoras.
Remove-UPPrinter Use este cmdlet para anular el registro de impresoras.

Propiedades de la impresora

Cmdlet Descripción
Set-UPPrinterProperty Use este cmdlet para actualizar las propiedades mutables de una impresora.

Recursos compartidos de impresoras

Cmdlet Descripción
New-UPPrinterShare Use este cmdlet para compartir una impresora.
Get-UPPrinterShare Use este cmdlet para obtener información sobre una sola o lista de impresoras compartidas.
Remove-UPPrinterShare Use este cmdlet para deshacer el uso compartido de impresoras que se han compartido anteriormente.
Set-UPPrinterShare Use este cmdlet para actualizar un recurso compartido de impresora para intercambiar una impresora registrada debido al mantenimiento con uno en funcionamiento.

Permisos de usuario

Cmdlet Descripción
Grant-UPAccess Use este cmdlet para conceder acceso de impresión a un usuario o grupo o a todos los usuarios de la organización.
Revoke-UPAccess Use este cmdlet para revocar el acceso de impresión desde un usuario o grupo o todos los usuarios de la organización.
Get-UPAllowedMember Use este cmdlet para obtener información sobre los usuarios y grupos que tienen acceso de impresión a una impresora específica.

Conectores

Cmdlet Descripción
Get-UP Conectar or Use este cmdlet para obtener información sobre una sola o lista de conectores.
Remove-UP Conectar or Use este cmdlet para anular el registro de conectores.

Propiedades de Conectar or

Cmdlet Descripción
Set-UP Conectar orProperty Use este cmdlet para actualizar las propiedades mutables de un conector.
Cmdlet Descripción
Get-UPPrintJob Use este cmdlet para obtener información sobre los trabajos de impresión que se enviaron a una impresora.
Cmdlet Descripción
Get-UPUsageReport Use este cmdlet para obtener diferentes tipos de informes de uso de impresión.