New-ModuleManifest

Especifica los alias que el módulo exporta. Se permite el uso de caracteres comodín.

Este parámetro se puede utilizar para restringir los alias que el módulo exporta. Puede quitar alias de la lista de alias exportados, pero no puede agregar alias a la lista.

Si se omite este parámetro, New-ModuleManifest creará una clave AliasesToExport cuyo valor será * (todo); esto significa que el manifiesto exportará todos los alias exportados por el módulo.

Especifica el autor del módulo.

El cmdlet requiere este parámetro, pero la clave Author no se requiere en el manifiesto. Si se omite este parámetro y no se especifica un valor cuando se solicite, New-ModuleManifest creará una clave Author con el nombre del usuario actual.

Especifica la versión de Common Language Runtime (CLR) de Microsoft .NET Framework que el módulo requiere.

Si se omite este parámetro, New-ModuleManifest creará una clave CLRVersion cuyo valor será una cadena vacía.

Especifica los cmdlets que el módulo exporta. Se permite el uso de caracteres comodín.

Este parámetro se puede utilizar para restringir los cmdlets que el módulo exporta. Puede quitar cmdlets de la lista de cmdlets exportados, pero no puede agregar cmdlets a la lista.

Si se omite este parámetro, New-ModuleManifest creará una clave CmdletsToExport cuyo valor será * (todo); esto significa que el manifiesto exportará todos los cmdlets exportados por el módulo.

Identifica la compañía o el proveedor que creó el módulo.

El cmdlet requiere este parámetro, pero la clave CompanyName no se requiere en el manifiesto. Si se omite este parámetro y no se especifica un valor cuando se solicite, New-ModuleManifest creará una clave CompanyName con el valor "Unknown".

Especifica una instrucción de copyright para el módulo.

El cmdlet requiere este parámetro, pero la clave Copyright no se requiere en el manifiesto. Si se omite este parámetro y no se especifica un valor cuando se solicite, New-ModuleManifest creará una clave Copyright con el valor "(c) <año> <nombreDeUsuario>. All rights reserved." donde <año> es el actual año y <nombreDeUsuario> es el valor de la clave Author o el nombre del usuario actual (si se ha especificado).

Describe el contenido del módulo.

El cmdlet requiere este parámetro, pero la clave Description no se requiere en el manifiesto. Si se omite este parámetro y no se especifica un valor cuando se solicite, New-ModuleManifest creará una clave Description cuyo valor será una cadena vacía.

Especifica la versión de Microsoft .NET Framework que el módulo requiere.

Si se omite este parámetro, New-ModuleManifest creará una clave DotNetFrameWorkVersion cuyo valor será una cadena vacía.

Especifica todos los elementos que se incluyen en el módulo.

Esta clave está diseñada para actuar como inventario de módulo. Estos archivos no se exportan automáticamente con el módulo.

El cmdlet requiere este parámetro, pero la clave FileList no se requiere en el manifiesto. Si se omite este parámetro y no se especifica un valor cuando se solicite, New-ModuleManifest creará una clave FileList cuyo valor será una matriz vacía.

Especifica los archivos de formato (.ps1xml) que se ejecutan al importar el módulo.

Al importar un módulo, Windows PowerShell ejecuta el cmdlet Update-FormatData con los archivos especificados. Dado que los archivos de formato no están supeditados a un ámbito concreto, afectan a todos los estados de sesión de la sesión.

El cmdlet requiere este parámetro, pero la clave FormatsToProcess no se requiere en el manifiesto. Si se omite este parámetro y no se especifica un valor cuando se solicite, New-ModuleManifest creará una clave FormatsToProcess cuyo valor será una matriz vacía.

Especifica las funciones que el módulo exporta. Se permite el uso de caracteres comodín.

Este parámetro se puede utilizar para restringir las funciones que el módulo exporta. Puede quitar funciones de la lista de funciones exportadas, pero no puede agregar funciones a la lista.

Si se omite este parámetro, New-ModuleManifest creará una clave FunctionsToExport cuyo valor será * (todo); esto significa que el manifiesto exportará todas las funciones exportadas por el módulo.

Especifica un identificador único para el módulo. Se puede usar el GUID para distinguir entre módulos con el mismo nombre.

Si omite este parámetro, New-ModuleManifest crea una clave de GUID en el manifiesto y genera un GUID para el valor.

Para crear un nuevo GUID en Windows PowerShell, escriba "[guid]::NewGuid()".

Muestra una lista de todos los módulos que se empaquetan con este módulo.

Escriba cada nombre de módulo como una cadena o escriba una tabla hash con las claves ModuleName y GUID. La tabla hash también puede tener una clave ModuleVersion opcional.

Esta clave está diseñada para actuar como inventario de módulo. Estos módulos no se procesan automáticamente.

Si se omite este parámetro, New-ModuleManifest creará una clave ModuleList en el manifiesto cuyo valor será una matriz vacía.

Especifica el archivo primario o "raíz" del módulo. Cuando se importa el módulo, los miembros que se exportan del archivo de módulo raíz se importan en el estado de sesión del autor de llamada. Escriba el nombre de archivo de un módulo de script (.psm1) o un módulo binario (.dll).

Si un módulo tiene un archivo de manifiesto y no se ha designado ningún archivo raíz en la clave ModuleToProcess, el manifiesto se convierte en el archivo primario del módulo y el módulo se convierte en un "módulo de manifiesto" (ModuleType = Manifest).

Para exportar miembros de .psm1 o archivos .dll en un módulo que tiene un manifiesto, los nombres de esos archivos se deben especificar en los valores de las claves NestedModules o ModuleToProcess en el manifiesto. De lo contrario, no se exportan sus miembros.

El cmdlet requiere este parámetro, pero la clave ModuleToProcess no se requiere en el manifiesto. Si se omite este parámetro y no se especifica un valor cuando se solicite, New-ModuleManifest creará una clave ModuleToProcess cuyo valor será una cadena vacía.

Especifica la versión del módulo.

El cmdlet no requiere este parámetro, pero se requiere una clave ModuleVersion en el manifiesto. Si se omite este parámetro, New-ModuleManifest creará una clave ModuleVersion con el valor "1.0".

Especifica los módulos de script (.psm1) y los módulos binarios (.dll) que se importan en el estado de sesión del módulo. Los archivos de la clave NestedModules se ejecutan en el orden en que se enumeran en el valor.

Normalmente, los módulos anidados contienen comandos que el módulo de raíz necesita para su procesamiento interno. De forma predeterminada, los comandos de los módulos anidados se exportan desde el estado de sesión del módulo al estado de sesión del autor de llamada, pero el módulo raíz puede restringir los comandos que exporta (por ejemplo, mediante el comando Export-Module).

Los módulos anidados en el estado de sesión del módulo están disponibles para el módulo raíz, pero un comando Get-Module no los devuelve en el estado de sesión del autor de llamada.

Los scripts (.ps1) que se enumeran en la clave NestedModules se ejecutan en el estado de sesión del módulo, no en el estado de sesión del autor de llamada. Para ejecutar un script en el estado de sesión del autor de llamada, se debe incluir el nombre del archivo de script en el valor de la clave ScriptsToProcess del manifiesto.

El cmdlet requiere este parámetro, pero la clave NestedModules no se requiere en el manifiesto. Si se omite este parámetro y no se especifica un valor cuando se solicite, New-ModuleManifest creará una clave NestedModules cuyo valor será una matriz vacía.

Escribe el manifiesto de módulo resultante en la consola, además de crear un archivo .psd1. De forma predeterminada, este cmdlet no genera resultados.

Especifica la ruta de acceso y el nombre de archivo del nuevo manifiesto de módulo. Escriba una ruta de acceso y un nombre de archivo con la extensión .psd1, como "$pshome\Modules\MyModule\MyModule.psd1". Este parámetro es obligatorio.

Si se especifica la ruta de acceso a un archivo existente, New-ModuleManifest reemplazará el archivo sin avisar, a menos que el archivo tenga el atributo de solo lectura.

El manifiesto debe ubicarse en el directorio del módulo y el nombre de archivo de manifiesto debe ser igual que el nombre de directorio del módulo, pero con la extensión .psd1.

Nota: no se pueden utilizar variables, como $pshome o $home, en respuesta a una solicitud de un valor de parámetro Path. Para utilizar una variable, incluya el parámetro Path en el comando.

Especifica el nombre del programa host de Windows PowerShell que el módulo requiere. Escriba el nombre del programa host, por ejemplo, "Host ISE de Windows PowerShell" o "ConsoleHost". No se permite el uso de caracteres comodín.

Para buscar el nombre de un programa host, se escribe "$host.name" en el programa.

Si se omite este parámetro, New-ModuleManifest creará una clave PowerShellHostName cuyo valor será una cadena vacía.

Especifica la versión mínima del programa host de Windows PowerShell que funciona con el módulo. Escriba un número de versión, como 1.1.

Si se omite este parámetro, New-ModuleManifest creará una clave PowerShellHostName cuyo valor será una cadena vacía.

Especifica la versión mínima de Windows PowerShell que funcionará con este módulo. Escriba 1.0 o 2.0. Los requisitos para versiones posteriores a 2.0 no son obligatorios.

Si se omite este parámetro, New-ModuleManifest creará una clave PowerShellVersion cuyo valor será una cadena vacía.

Especifica los datos que se pasan al módulo cuando se importa.

Si se omite este parámetro, New-ModuleManifest creará una clave PrivateData cuyo valor será una cadena vacía.

Especifica la arquitectura de procesador que el módulo requiere. Los valores válidos son x86, AMD64, IA64 y None (desconocido o no especificado).

Si se omite este parámetro, New-ModuleManifest creará una clave ProcessorArchitecture cuyo valor es una cadena vacía.

Especifica los archivos de ensamblado (.dll) que el módulo requiere. Windows PowerShell carga los ensamblados especificados antes de que se actualicen los tipos o los formatos, se importen los módulos anidados o se importe el archivo de módulo que se especifica en el valor de la clave ModuleToProcess.

Este parámetro se utiliza para mostrar una lista de todos los ensamblados que el módulo requiere, incluso los que se deben cargar para actualizar los archivos de formato o tipo enumerados en las claves TypesToProcess o FormatsToProcess, aunque también se enumeren como módulos binarios en la clave NestedModules.

El cmdlet requiere este parámetro, pero la clave RequiredAssemblies no se requiere en el manifiesto. Si se omite este parámetro y no se especifica un valor cuando se solicite, New-ModuleManifest creará una clave RequiredAssemblies cuyo valor será una matriz vacía.

Especifica los módulos que deben estar en el estado de sesión global. Si los módulos requeridos no están en el estado de sesión global, se producirá un error al intentar importar este módulo.

Escriba cada nombre de módulo como una cadena o escriba una tabla hash con las claves ModuleName y GUID. La tabla hash también puede tener una clave ModuleVersion opcional. Para obtener más información, vea los ejemplos.

Windows PowerShell no importa los módulos requeridos automáticamente. Se limita a comprobar que los módulos requeridos están presentes. Sin embargo, los módulos pueden incluir scripts (.ps1) que importen los módulos requeridos al estado de sesión global.

Si se omite este parámetro, New-ModuleManifest creará una clave RequiredModules cuyo valor será una matriz vacía.

Especifica los archivos de script (.ps1) que se ejecutan en el estado de sesión del autor de llamada al importar el módulo. Estos scripts se pueden utilizar para preparar un entorno, del mismo modo que se haría con un script de inicio de sesión.

Para especificar scripts que se ejecuten en la sesión del módulo, se utiliza la clave NestedModules.

Si se omite este parámetro, New-ModuleManifest creará una clave ScriptsToProcess cuyo valor será una matriz vacía.

Especifica los archivos de tipo (.ps1xml) que se ejecutan al importar el módulo.

Al importar el módulo, Windows PowerShell ejecuta el cmdlet Update-TypeData con los archivos especificados. Dado que los archivos de tipo no están supeditados a un ámbito concreto, afectan a todos los estados de sesión de la sesión.

El cmdlet requiere este parámetro, pero la clave TypesToProcess no se requiere en el manifiesto. Si se omite este parámetro y no se especifica un valor cuando se solicite, New-ModuleManifest creará una clave TypesToProcess cuyo valor será una matriz vacía.

Especifica las variables que el módulo exporta. Se permite el uso de caracteres comodín.

Este parámetro se puede utilizar para restringir las variables que el módulo exporta. Puede quitar variables de la lista de variables exportadas, pero no puede agregar variables a la lista.

Si se omite este parámetro, New-ModuleManifest creará una clave VariablesToExport cuyo valor será * (todo); esto significa que el manifiesto exportará todas las variables exportadas por el módulo.

Solicita confirmación antes de ejecutar el comando.

Describe lo que ocurriría si se ejecutara el comando, sin ejecutarlo realmente.

Este cmdlet admite los parámetros comunes: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer y -OutVariable. Para obtener más información, vea about_Commonparameters.