módulo de PowerShell para Impresión universal

El UniversalPrintManagement PowerShell module 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 utilice PSGallery verá el siguiente mensaje:

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 Connect-UPService cmdlet .

Connect-UPService

Obtendrá un cuadro de diálogo de inicio de sesión para proporcionar un nombre de usuario y una contraseña para la 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 la sintaxis Connect-UPService -UserPrincipalName [email protected] -Password $variableHoldingSecureString y recuperando 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 paginar colecciones grandes y reintentar las 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. Vea ejemplos aquí.

Inicio de sesión

Cmdlet Descripción
Connect-UPService Se conecta con una cuenta autenticada para usarla en las solicitudes de cmdlets de Impresión universal.

Printers

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 Utilice este cmdlet para dejar de compartir impresoras que se hayan compartido anteriormente.
Set-UPPrinterShare Utilice este cmdlet para actualizar el recurso compartido de una impresora y sustituir una impresora registrada que requiere mantenimiento por otra que funcione.

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.

Connectors

Cmdlet Descripción
Get-UPConnector Use este cmdlet para obtener información sobre una sola o lista de conectores.
Quitar UPConnector Use este cmdlet para anular el registro de conectores.

Propiedades del conector

Cmdlet Descripción
Set-UPConnectorProperty 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.
  • Last updated on