Save-Help
Descarga y guarda los archivos de ayuda más recientes en un directorio del sistema de archivos.
Sintaxis
Path (valor predeterminado)
Save-Help
[-DestinationPath] <String[]>
[[-Module] <PSModuleInfo[]>]
[[-UICulture] <CultureInfo[]>]
[-FullyQualifiedModule <ModuleSpecification[]>]
[-Credential <PSCredential>]
[-UseDefaultCredentials]
[-Force]
[-Scope <UpdateHelpScope>]
[<CommonParameters>]
LiteralPath
Save-Help
[[-Module] <PSModuleInfo[]>]
[[-UICulture] <CultureInfo[]>]
-LiteralPath <String[]>
[-FullyQualifiedModule <ModuleSpecification[]>]
[-Credential <PSCredential>]
[-UseDefaultCredentials]
[-Force]
[-Scope <UpdateHelpScope>]
[<CommonParameters>]
Description
El Save-Help cmdlet descarga los archivos de ayuda más recientes para los módulos de PowerShell y los guarda en un directorio que especifique. Esta característica le permite actualizar los archivos de ayuda en equipos que no tienen acceso a Internet y facilita la actualización de los archivos de ayuda en varios equipos.
En Windows PowerShell 3.0, Save-Help solo funcionaba para los módulos instalados en el equipo local. Aunque era posible importar un módulo desde un equipo remoto u obtener una referencia a un objeto PSModuleInfo desde un equipo remoto mediante la comunicación remota de PowerShell, la propiedad HelpInfoUri no se conservaba y Save-Help no funcionaba para la Ayuda del módulo remoto.
En Windows PowerShell 4.0, la propiedad HelpInfoUri se conserva en la comunicación remota de PowerShell, lo que permite Save-Help trabajar con módulos instalados en equipos remotos. También es posible guardar un objeto PSModuleInfo en un disco o en un medio extraíble ejecutándolo Export-Clixml en un equipo que no tenga acceso a Internet, importando el objeto en un equipo que sí tenga acceso a Internet y, a continuación, ejecutándolo Save-Help en el objeto PSModuleInfo . La ayuda guardada se puede transportar al equipo remoto mediante medios de almacenamiento extraíbles, como una unidad USB. La ayuda se puede instalar en el equipo remoto ejecutando Update-Help. Este proceso se puede usar para instalar ayuda en equipos que no tienen ningún tipo de acceso a la red.
Para instalar archivos de ayuda guardados, ejecute el Update-Help cmdlet. Agregue su parámetro SourcePath para especificar la carpeta en la que guardó los archivos de Ayuda.
Sin parámetros, un Save-Help comando descarga la ayuda más reciente para todos los módulos de la sesión y para los módulos que se instalan en el equipo en una ubicación que aparece en la variable de entorno PSModulePath . Esta acción omite los módulos que no admiten ayuda actualizable sin advertencia.
El Save-Help cmdlet comprueba la versión de los archivos de ayuda de la carpeta de destino. Si hay archivos de ayuda más recientes disponibles, este cmdlet descarga los archivos de ayuda más recientes de Internet y, a continuación, los guarda en la carpeta . El Save-Help cmdlet funciona igual que el Update-Help cmdlet, excepto que guarda los archivos de gabinete descargados (.cab), en lugar de extraer los archivos de ayuda de los archivos de gabinete e instalarlos en el equipo.
La ayuda guardada para cada módulo consta de un archivo de información de ayuda (HelpInfo XML) y un archivo de gabinete (.cab) para los archivos de ayuda de cada referencia cultural de la interfaz de usuario. No es necesario extraer los archivos de ayuda del archivo de gabinete. El Update-Help cmdlet extrae los archivos de ayuda, valida el XML para su seguridad y, a continuación, instala los archivos de ayuda y el archivo de información de ayuda en una subcarpeta específica del idioma de la carpeta del módulo.
Para guardar los archivos de ayuda de los módulos en la carpeta de instalación de PowerShell ($pshome\Modules), inicie PowerShell mediante la opción Ejecutar como administrador. Debe ser miembro del grupo Administradores del equipo para descargar los archivos de ayuda de estos módulos.
Este cmdlet se introdujo en Windows PowerShell 3.0.
Ejemplos
Ejemplo 1: Guardar la ayuda para el módulo DhcpServer
# Option 1: Run Invoke-Command to get the PSModuleInfo object for the remote DHCP Server module,
# save the PSModuleInfo object in the variable $m, and then run Save-Help.
$m = Invoke-Command -ComputerName RemoteServer -ScriptBlock { Get-Module -Name DhcpServer -ListAvailable }
Save-Help -Module $m -DestinationPath "C:\SavedHelp"
# Option 2: Open a PSSession--targeted at the remote computer that is running the DhcpServer
# module--to get the PSModuleInfo object for the remote module, and then run Save-Help.
$s = New-PSSession -ComputerName "RemoteServer"
$m = Get-Module -PSSession $s -Name "DhcpServer" -ListAvailable
Save-Help -Module $m -DestinationPath "C:\SavedHelp"
# Option 3: Open a CIM session--targeted at the remote computer that is running the DhcpServer
# module--to get the PSModuleInfo object for the remote module, and then run Save-Help.
$c = New-CimSession -ComputerName "RemoteServer"
$m = Get-Module -CimSession $c -Name "DhcpServer" -ListAvailable
Save-Help -Module $m -DestinationPath "C:\SavedHelp"
En este ejemplo se muestran tres formas diferentes de guardar Save-Help la ayuda del módulo DhcpServer desde un equipo cliente conectado a Internet, sin instalar el módulo DhcpServer o la función de servidor DHCP en el equipo local.
Ejemplo 2: Instalación de la ayuda para el módulo DhcpServer
# First, run Export-CliXml to export the PSModuleInfo object to a shared folder or to removable media.
$m = Get-Module -Name "DhcpServer" -ListAvailable
Export-CliXml -Path "E:\UsbFlashDrive\DhcpModule.xml" -InputObject $m
# Next, transport the removable media to a computer that has Internet access, and then import the
# PSModuleInfo object with Import-CliXml. Run Save-Help to save the Help for the imported DhcpServer
# module PSModuleInfo object.
$deserialized_m = Import-CliXml "E:\UsbFlashDrive\DhcpModule.xml"
Save-Help -Module $deserialized_m -DestinationPath "E:\UsbFlashDrive\SavedHelp"
# Finally, transport the removable media back to the computer that does not have network access, and
# then install the help by running Update-Help.
Update-Help -Module DhcpServer -SourcePath "E:\UsbFlashDrive\SavedHelp"
En este ejemplo se muestra cómo instalar ayuda que guardó en el ejemplo 1 del módulo DhcpServer de
Ejemplo 3: Guardar ayuda para todos los módulos
Save-Help -DestinationPath "\\Server01\FileShare01"
Este comando descarga los archivos de ayuda más recientes para todos los módulos del conjunto de referencia cultural de la interfaz de usuario para Windows en el equipo local. Guarda los archivos de ayuda en la \\Server01\Fileshare01 carpeta .
Ejemplo 4: Guardar ayuda para un módulo en el equipo
Save-Help -Module ServerManager -DestinationPath "\\Server01\FileShare01" -Credential Domain01/Admin01
Este comando descarga los archivos de ayuda más recientes para el módulo ServerManager y, a continuación, los guarda en la \\Server01\Fileshare01 carpeta .
Cuando se instala un módulo en el equipo, puede escribir el nombre del módulo como valor del parámetro Module, incluso si el módulo no se importa en la sesión actual.
El comando usa el parámetro Credential para proporcionar las credenciales de un usuario que tiene permiso para escribir en el recurso compartido de archivos.
Ejemplo 5: Guardar ayuda para un módulo en otro equipo
Invoke-Command -ComputerName Server02 {Get-Module -Name CustomSQL -ListAvailable} | Save-Help -DestinationPath \\Server01\FileShare01 -Credential Domain01\Admin01
Estos comandos descargan los archivos de ayuda más recientes para el módulo CustomSQL y los guardan en la \\Server01\Fileshare01 carpeta .
Dado que el módulo CustomSQL no está instalado en el equipo, la secuencia incluye un Invoke-Command comando que obtiene el objeto de módulo para el módulo CustomSQL del equipo Server02 y, a continuación, canaliza el objeto de módulo al Save-Help cmdlet.
Cuando un módulo no está instalado en el equipo, Save-Help necesita el objeto module, que incluye información sobre la ubicación de los archivos de ayuda más recientes.
Ejemplo 6: Guardar ayuda para un módulo en varios idiomas
Save-Help -Module Microsoft.PowerShell* -UICulture de-DE, en-US, fr-FR, ja-JP -DestinationPath "D:\Help"
Este comando guarda ayuda para los módulos principales de PowerShell en cuatro referencias culturales de interfaz de usuario diferentes. Los paquetes de idioma de estas configuraciones regionales no tienen que instalarse en el equipo.
Save-Help puede descargar archivos de ayuda para módulos en diferentes referencias culturales de interfaz de usuario solo cuando el propietario del módulo hace que los archivos traducidos estén disponibles en Internet.
Ejemplo 7: Guardar ayuda más de una vez cada día
Save-Help -Force -DestinationPath "\\Server3\AdminShare\Help"
Este comando guarda la ayuda de todos los módulos instalados en el equipo. El comando especifica el parámetro Force para invalidar la regla que impide que el Save-Help cmdlet descargue ayuda más de una vez en cada período de 24 horas.
El parámetro Force también invalida la restricción de 1 GB y evita la comprobación de versiones. Por lo tanto, puede descargar archivos incluso si la versión no es posterior a la versión de la carpeta de destino.
El comando usa el Save-Help cmdlet para descargar y guardar los archivos de ayuda en la carpeta especificada.
El parámetro Force es necesario cuando tiene que ejecutar un comando más de una Save-Help vez cada día.
Parámetros
-Credential
Especifica una credencial de usuario. Este cmdlet ejecuta el comando mediante credenciales de un usuario que tiene permiso para acceder a la ubicación del sistema de archivos especificada por el parámetro DestinationPath . Este parámetro solo es válido cuando se usa el parámetro DestinationPath o LiteralPath en el comando .
Este parámetro permite ejecutar Save-Help comandos que usan el parámetro DestinationPath en equipos remotos. Al proporcionar credenciales explícitas, puede ejecutar el comando en un equipo remoto y acceder a un recurso compartido de archivos en un tercer equipo sin encontrar un error de acceso denegado o usar la autenticación CredSSP para delegar las credenciales.
Escriba un nombre de usuario, como User01 o Domain01\User01, o escriba un objeto de PSCredential generado por el cmdlet Get-Credential. Si escribe un nombre de usuario, se le pedirá que escriba la contraseña.
Las credenciales se almacenan en un objeto PSCredential y la contraseña se almacena como SecureString.
Nota:
Para obtener más información sobre la protección de datos de SecureString, consulte ¿Qué tan segura es SecureString?.
Propiedades de parámetro
| Tipo: | PSCredential |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-DestinationPath
Especifica la ruta de acceso de la carpeta en la que se guardan los archivos de ayuda. No especifique un nombre de archivo ni una extensión de nombre de archivo.
Propiedades de parámetro
| Tipo: | String[] |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
| Alias: | Ruta |
Conjuntos de parámetros
Path
| Posición: | 0 |
| Obligatorio: | True |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-Force
Indica que este cmdlet no sigue la limitación de una vez al día, omite la comprobación de versiones y descarga archivos que superan el límite de 1 GB.
Sin este parámetro, solo se permite un Save-Help comando para cada módulo en cada período de 24 horas, las descargas están limitadas a 1 GB de contenido sin comprimir por módulo y los archivos de ayuda para un módulo se instalan solo cuando son más recientes que los archivos en la computadora.
El límite de una vez al día protege los servidores que hospedan los archivos de ayuda y le permite agregar un Save-Help comando a su perfil de PowerShell.
Para guardar la ayuda de un módulo en varias referencias culturales de interfaz de usuario sin el parámetro Force , incluya todas las referencias culturales de la interfaz de usuario en el mismo comando, como: Save-Help -Module PSScheduledJobs -UICulture en-US, fr-FR, pt-BR
Propiedades de parámetro
| Tipo: | SwitchParameter |
| Valor predeterminado: | False |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-FullyQualifiedModule
El valor puede ser un nombre de módulo, una especificación de módulo completa o una ruta de acceso a un archivo de módulo.
Cuando el valor es una ruta de acceso, la ruta de acceso puede ser completa o relativa. Se resuelve una ruta de acceso relativa con respecto al script que contiene la instrucción using.
Cuando el valor es un nombre o especificación de módulo, PowerShell busca en el psModulePath
Una especificación de módulo es una tabla hash que tiene las siguientes claves.
-
ModuleName- Required Especifica el nombre del módulo. -
GUID- opcional Especifica el GUID del módulo. - También es obligatorio especificar al menos una de las tres claves siguientes.
-
ModuleVersion: especifica una versión mínima aceptable del módulo. -
MaximumVersion: especifica la versión máxima aceptable del módulo. -
RequiredVersion: especifica una versión exacta y necesaria del módulo. Esto no se puede usar con las otras claves de versión.
-
No se puede especificar el parámetro FullyQualifiedModule en el mismo comando que un parámetro Module. los dos parámetros son mutuamente excluyentes.
Propiedades de parámetro
| Tipo: | |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | True |
| Valor de los argumentos restantes: | False |
-LiteralPath
Especifica una ruta de acceso de la carpeta de destino. A diferencia del valor del parámetro DestinationPath, el valor del parámetro LiteralPath se usa exactamente como se escribe. Ningún carácter se interpreta como carácter comodín. Si la ruta de acceso incluye caracteres de escape, escríbala entre comillas simples. Las comillas simples indican a PowerShell que no interprete ningún carácter como secuencias de escape.
Propiedades de parámetro
| Tipo: | String[] |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
| Alias: | PSPath, LP |
Conjuntos de parámetros
LiteralPath
| Posición: | Named |
| Obligatorio: | True |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-Module
Especifica los módulos para los que este cmdlet descarga ayuda. Escriba uno o varios nombres de módulo o patillas de nombres en una lista separada por comas o en un archivo que tenga un nombre de módulo en cada línea. Se permite el uso de caracteres comodín. También puede canalizar objetos de módulo desde el Get-Module cmdlet a Save-Help.
De forma predeterminada, Save-Help descarga ayuda para todos los módulos que admiten ayuda actualizable y se instalan en el equipo local en una ubicación que aparece en la variable de entorno PSModulePath .
Para guardar la ayuda de los módulos que no están instalados en el equipo, ejecute un Get-Module comando en un equipo remoto. A continuación, canalice los objetos de módulo resultantes al Save-Help cmdlet o envíe los objetos de módulo como valor de los parámetros Module o InputObject .
Si el módulo que especifique está instalado en el equipo, puede escribir el nombre del módulo o un objeto de módulo. Si el módulo no está instalado en el equipo, debe escribir un objeto de módulo, como uno devuelto por el Get-Module cmdlet.
El parámetro Module del Save-Help cmdlet no acepta la ruta de acceso completa de un archivo de módulo o un archivo de manifiesto de módulo. Para guardar la ayuda de un módulo que no está en una ubicación de PSModulePath , importe el módulo en la sesión actual antes de ejecutar el Save-Help comando.
Un valor de "*" (todos) intenta actualizar la ayuda de todos los módulos instalados en el equipo. Esto incluye módulos que no admiten ayuda actualizable. Este valor puede generar errores cuando el comando encuentra módulos que no admiten ayuda actualizable.
Propiedades de parámetro
| Tipo: | |
| Valor predeterminado: | None |
| Admite caracteres comodín: | True |
| DontShow: | False |
| Alias: | Nombre |
Conjuntos de parámetros
(All)
| Posición: | 1 |
| Obligatorio: | False |
| Valor de la canalización: | True |
| Valor de la canalización por nombre de propiedad: | True |
| Valor de los argumentos restantes: | False |
-Scope
Este parámetro no hace nada en este cmdlet.
Propiedades de parámetro
| Tipo: | UpdateHelpScope |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | True |
| Valor de los argumentos restantes: | False |
-UICulture
Especifica los valores de referencia cultural de la interfaz de usuario para los que este cmdlet obtiene archivos de ayuda actualizados. Escriba uno o varios códigos de idioma, como es-ES, una variable que contenga objetos de referencia cultural o un comando que obtenga objetos de referencia cultural, como un comando Get-Culture o Get-UICulture.
No se admite el uso de caracteres comodín. No especifique un código de lenguaje parcial, como "de".
De forma predeterminada, Save-Help obtiene archivos de ayuda en la referencia cultural de la interfaz de usuario establecida para Windows o su referencia cultural de reserva.
Si especifica el parámetro UICulture , Save-Help busca ayuda solo para la referencia cultural de interfaz de usuario especificada, no en ninguna referencia cultural de reserva.
Propiedades de parámetro
| Tipo: | |
| Valor predeterminado: | Current UI culture |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | 2 |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-UseDefaultCredentials
Indica que este cmdlet ejecuta el comando, incluida la descarga web, con las credenciales del usuario actual. De forma predeterminada, el comando se ejecuta sin credenciales explícitas.
Este parámetro solo es efectivo cuando la descarga web usa NTLM, negotiate o autenticación basada en Kerberos.
Propiedades de parámetro
| Tipo: | SwitchParameter |
| Valor predeterminado: | False |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
CommonParameters
Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para obtener más información, vea about_CommonParameters.
Entradas
PSModuleInfo
Puede canalizar un objeto de módulo a este cmdlet.
Salidas
None
Este cmdlet no devuelve ninguna salida.
Notas
- Para guardar la ayuda de los módulos en la carpeta $pshome\Modules, inicie PowerShell mediante la opción Ejecutar como administrador. Solo los miembros del grupo Administradores del equipo pueden descargar ayuda para los módulos de la carpeta $pshome\Modules.
- La ayuda guardada para cada módulo consta de un archivo de información de ayuda (HelpInfo XML) y un archivo de gabinete (.cab) para los archivos de ayuda de cada referencia cultural de la interfaz de usuario. No es necesario extraer los archivos de ayuda del archivo de gabinete. El
Update-Helpcmdlet extrae los archivos de ayuda, valida el XML y, a continuación, instala los archivos de ayuda y el archivo de información de ayuda en una subcarpeta específica del lenguaje de la carpeta del módulo. - El
Save-Helpcmdlet puede guardar ayuda para los módulos que no están instalados en el equipo. Sin embargo, dado que los archivos de ayuda están instalados en la carpeta del módulo, el cmdlet puede instalar elUpdate-Helparchivo de ayuda actualizado solo para los módulos instalados en el equipo. - Si
Save-Helpno se pueden encontrar los archivos de ayuda actualizados para un módulo o no se pueden encontrar los archivos de ayuda actualizados en el idioma especificado, continúa silenciosamente sin mostrar un mensaje de error. Para ver qué archivos guardó el comando, especifique el parámetro Verbose . - Los módulos son la unidad más pequeña de ayuda actualizable. No se puede guardar la ayuda de un cmdlet determinado, solo para todos los cmdlets del módulo. Para buscar el módulo que contiene un cmdlet determinado, use la propiedad ModuleName junto con el
Get-Commandcmdlet , por ejemplo,(Get-Command \<cmdlet-name\>).ModuleName -
Save-Helpadmite todos los módulos y los complementos principales de PowerShell. No admite ningún otro complemento. - Los cmdlets
Update-HelpySave-Helpusan los siguientes puertos para descargar archivos de ayuda: Puerto 80 para HTTP y puerto 443 para HTTPS. - Los cmdlets
Update-HelpySave-Helpno se admiten en el entorno de preinstalación de Windows (Windows PE).