Save-Help
Descarga y guarda los archivos de ayuda más recientes en un directorio del sistema de archivos.
Syntax
Save-Help
[-DestinationPath] <String[]>
[[-Module] <PSModuleInfo[]>]
[-FullyQualifiedModule <ModuleSpecification[]>]
[[-UICulture] <CultureInfo[]>]
[-Credential <PSCredential>]
[-UseDefaultCredentials]
[-Force]
[<CommonParameters>]Save-Help
-LiteralPath <String[]>
[[-Module] <PSModuleInfo[]>]
[-FullyQualifiedModule <ModuleSpecification[]>]
[[-UICulture] <CultureInfo[]>]
[-Credential <PSCredential>]
[-UseDefaultCredentials]
[-Force]
[<CommonParameters>]Description
El cmdlet Save-Help 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 permite actualizar los archivos de ayuda en los 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 funcionó para los módulos instalados en el equipo local. Aunque era posible importar un módulo desde un equipo remoto o 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 funcionaría para la Ayuda remota del módulo.
En Windows PowerShell 4.0, la propiedad HelpInfoUri se conserva a través de la comunicación remota de PowerShell, lo que permite que Save-Help funcione para los módulos instalados en equipos remotos. También es posible guardar un objeto PSModuleInfo en disco o medios extraíbles mediante la ejecución de Export-Clixml en un equipo que no tiene acceso a Internet, importar el objeto en un equipo que tenga acceso a Internet y, a continuación, ejecutar 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 la ayuda en equipos que no tienen ningún tipo de acceso de red.
Para instalar los archivos de ayuda guardados, ejecute el cmdlet Update-Help. Agregue su parámetro SourcePath para especificar la carpeta en la que guardó los archivos de Ayuda.
Sin parámetros, un comando Save-Help descarga la ayuda más reciente para todos los módulos de la sesión y para los módulos instalados en el equipo, en una ubicación que se indica en la variable de entorno PSModulePath. Esta acción omite los módulos que no admiten la Ayuda actualizable sin advertencia.
El cmdlet Save-Help comprueba la versión de los archivos de ayuda de la carpeta de destino. Si hay nuevos archivos de ayuda disponibles, este cmdlet descarga los archivos de ayuda más recientes de Internet y, a continuación, los guarda en la carpeta . El cmdlet Save-Help funciona igual que el cmdlet Update-Help, salvo que guarda los archivos de archivador (.cab) descargados, 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 contenedor (.cab) para los archivos de ayuda de cada referencia cultural de interfaz de usuario. No es necesario extraer los archivos de ayuda del archivo archivador. El cmdlet Update-Help extrae los archivos de ayuda, valida el XML para la 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 en el 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 maneras diferentes de usar Save-Help para guardar la ayuda del módulo DhcpServer desde un equipo cliente conectado a Internet, sin instalar el módulo DhcpServer o el rol Servidor DHCP en el equipo local.
Ejemplo 2: Instalar 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 en un equipo que no tiene acceso a Internet.
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 de la referencia cultural de interfaz de usuario establecida para Windows en el equipo local. Guarda los archivos de ayuda en la carpeta \\Server01\Fileshare01.
Ejemplo 4: Guardar ayuda para un módulo en el equipo
Save-Help -Module ServerManager -DestinationPath "\\Server01\FileShare01" -Credential Domain01/Admin01Este comando descarga los archivos de ayuda más recientes para el módulo ServerManager y, a continuación, los guarda en la carpeta \\Server01\Fileshare01.
Cuando se instala un módulo en el equipo, puede escribir el nombre del módulo como el valor del parámetro Module, aunque el módulo no se importe a la sesión actual.
El comando utiliza 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 un equipo diferente
Invoke-Command -ComputerName Server02 {Get-Module -Name CustomSQL -ListAvailable} | Save-Help -DestinationPath \\Server01\FileShare01 -Credential Domain01\Admin01Estos comandos descargan los archivos de ayuda más recientes para el módulo CustomSQL y los guardan en la carpeta \\Server01\Fileshare01.
Dado que el módulo CustomSQL no está instalado en el equipo, la secuencia incluye un comando Invoke-Command 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 cmdlet Save-Help .
Cuando un módulo no está instalado en el equipo, Save-Help necesita el objeto de módulo, que incluye información acerca de 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 de PowerShell Core 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 la 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 al día
Save-Help -Force -DestinationPath "\\Server3\AdminShare\Help"Este comando guarda la ayuda de todos los módulos que están instalados en el equipo. El comando especifica el parámetro Force para invalidar la regla que impide que el cmdlet Save-Help 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 cmdlet Save-Help para descargar y guardar los archivos de ayuda en la carpeta especificada. El parámetro Force es necesario cuando tiene que ejecutar un comando Save-Help más de una vez al 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 usan los parámetros DestinationPath o LiteralPath en el comando.
Este parámetro permite ejecutar comandos Save-Help 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.
| Type: | PSCredential |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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 la extensión de nombre de archivo.
| Type: | String[] |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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 comando Save-Help para cada módulo en cada período de 24 horas, las descargas se limitan a 1 GB de contenido no comprimido por módulo y los archivos de ayuda de un módulo se instalan solo si son más recientes que los archivos del equipo.
El límite de una vez al día protege los servidores que hospedan los archivos de ayuda y le permite agregar un comando Save-Help al perfil de PowerShell.
Para guardar la ayuda de un módulo en varias referencias culturales de la 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
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-FullyQualifiedModule
Especifica módulos con nombres especificados en forma de objetos ModuleSpecification. Esto se describe en la sección Comentarios del Constructor ModuleSpecification (Hashtable) de MSDN Library. Por ejemplo, el parámetro FullyQualifiedModule acepta un nombre de módulo especificado con el formato @{ModuleName = "modulename"; ModuleVersion = "version_number"} o @{ModuleName = "modulename"; ModuleVersion = "version_number"; Guid = "GUID"}. ModuleName y ModuleVersion son necesarios, pero Guid es opcional.
No se puede especificar el parámetro FullyQualifiedModule en el mismo comando que un parámetro Module .
| Type: | ModuleSpecification[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | 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 ha escrito. Ningún carácter se interpreta como carácter comodín. Si la ruta de acceso contiene caracteres de escape, escríbalos entre comillas simples. Las comillas simples indican a PowerShell que no interprete caracteres como secuencias de escape.
| Type: | String[] |
| Aliases: | PSPath |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Module
Especifica los módulos para los que este cmdlet descarga la 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 cmdlet Get-Module a Save-Help.
De forma predeterminada, Save-Help descarga la ayuda de todos los módulos que admiten ayuda actualizable y que están instalados en el equipo local, en una ubicación que se indica en la variable de entorno PSModulePath.
Para guardar la ayuda de los módulos que no están instalados en el equipo, ejecute un comando Get-Module en un equipo remoto. Luego, canalice los objetos de módulo resultantes al cmdlet Save-Help o envíe los objetos de módulo como el valor de los parámetros Module o InputObject.
Si el módulo especificado 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 especificar un objeto de módulo, por ejemplo, uno devuelto por el cmdlet Get-Module.
El parámetro Module del cmdlet Save-Help no acepta la ruta de acceso completa de un archivo de módulo o archivo de manifiesto de módulo. Para guardar la ayuda de un módulo que no está en una ubicación PSModulePath , importe el módulo en la sesión actual antes de ejecutar el comando Save-Help .
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.
| Type: | PSModuleInfo[] |
| Aliases: | Name |
| Position: | 1 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | True |
-UICulture
Especifica los valores de referencia cultural de la interfaz de usuario para los que este cmdlet obtiene los 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 los archivos de ayuda en la referencia cultural de interfaz de usuario establecida para Windows o la 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.
| Type: | CultureInfo[] |
| Position: | 2 |
| Default value: | Current UI culture |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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 tiene efecto si la descarga web utiliza autenticación NTLM, Negotiate o basada en Kerberos.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Entradas
Puede canalizar un objeto de módulo desde el cmdlet Get-Module al parámetro Module de Save-Help.
Salidas
None
Este cmdlet no genera ningún resultado.
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 contenedor (.cab) para los archivos de ayuda de cada referencia cultural de interfaz de usuario. No es necesario extraer los archivos de ayuda del archivo archivador. El cmdlet Update-Help 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 idioma de la carpeta del módulo.
- El cmdlet Save-Help puede guardar la ayuda de los módulos que no están instalados en el equipo. Sin embargo, dado que los archivos de ayuda se instalan en la carpeta del módulo, el cmdlet Update-Help puede instalar el archivo de ayuda actualizado solo para los módulos instalados en el equipo.
- Si Save-Help no encuentra ayuda actualizada para un módulo o no encuentra archivos de ayuda actualizados en el idioma especificado, continúa en modo silencioso 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 cmdlet Get-Command, por ejemplo,
(Get-Command \<cmdlet-name\>).ModuleName - Save-Help admite todos los módulos y los complementos de PowerShell Core. No admite ningún otro complemento.
- Los cmdlets Update-Help y Save-Help usan los siguientes puertos para descargar los archivos de ayuda: Puerto 80 para HTTP y puerto 443 para HTTPS.
- Los cmdlets Update-Help y Save-Help no son compatibles en el entorno de preinstalación de Windows (Windows PE).