Announcement
Este repositorio ha quedado obsoleto. El módulo PackageManagementProviderResource se ha fusionado con PackageManagement. Utilice https://github.com/OneGet/oneget en el futuro. ¡Gracias!
PackageManagementProviderResource son los recursos de DSC para los proveedores de PackageManagement (también conocido como OneGet). Actualmente contiene los recursos DSC del proveedor Nuget y PowerShellGet para permitirle administrar paquetes y módulos de Windows PowerShell.
Consulte las pautas comunes de contribución de recursos de DSC.
PackageManagement : un proveedor genérico de PackageManagement que le permite descargar e instalar paquetes desde cualquier fuente. Este proveedor utiliza los cmdlets Install-Package y Get-Package. Es posible que deba utilizar el recurso DSC PackageManagementSource para registrar fuentes no predeterminadas.
NugetPackage : le permite descargar paquetes desde la ubicación de origen de NuGet (por ejemplo, http://nuget.org/api/v2/) e instalar o desinstalar el paquete.
PSModule : le permite descargar módulos de Windows PowerShell desde la Galería de PowerShell, "PSGallery" (por ejemplo, https://www.powershellgallery.com/api/v2/) e instalarlos en su computadora.
PackageManagementSource : le permite registrar o cancelar el registro de una fuente de paquete en su computadora
El recurso DSC PackageManagement tiene las siguientes propiedades:
| Propiedad | Descripción |
| Nombre | Especifica el nombre del paquete que se instalará o desinstalará. |
| Fuente | Especifica el nombre del origen del paquete donde se puede encontrar el paquete. Puede ser un URI o un origen registrado con el cmdlet Register-PackageSource o el recurso DSC PackageManagementSource. El recurso DSC MSFT_PackageManagementSource también puede registrar un origen de paquete. |
| Asegurar | Determina si el paquete se va a instalar o desinstalar. |
| Versión requerida | Especifica la versión exacta del paquete que desea instalar. Si no especifica este parámetro, este recurso DSC instala la versión más reciente disponible del paquete que también satisface cualquier versión máxima especificada por el parámetro MaximumVersion. |
| Versión mínima | Especifica la versión mínima permitida del paquete que desea instalar. Si no agrega este parámetro, este recurso DSC instala la versión más alta disponible del paquete que también satisface cualquier versión máxima especificada por el parámetro MaximumVersion. |
| Versión máxima | Especifica la versión máxima permitida del paquete que desea instalar. Si no especifica este parámetro, este recurso DSC instala la versión disponible del paquete con el número más alto. |
| FuenteCredencial | Especifica una cuenta de usuario que tiene derechos para instalar un paquete para un proveedor o fuente de paquetes especificado. |
| Nombre del proveedor | Especifica un nombre de proveedor de paquetes al que limitar la búsqueda de paquetes. Puede obtener los nombres de los proveedores de paquetes ejecutando el cmdlet Get-PackageProvider. |
| Parámetros adicionales | Parámetros específicos del proveedor que se pasan como Hashtable. Por ejemplo, para el proveedor NuGet puede pasar parámetros adicionales como DestinationPath. |
El recurso NugetPackage DSC tiene las siguientes propiedades:
| Propiedad | Descripción |
| Nombre | Especifica el nombre del paquete que se instalará o desinstalará. |
| Ruta de destino | Especifica una ubicación de archivo donde desea instalar el paquete. |
| Asegurar | Determina si el paquete se va a instalar o desinstalar. |
| Política de instalación | Determina si confía en la fuente del paquete. |
| Versión requerida | Especifica la versión exacta del paquete que desea instalar o desinstalar. |
| Versión mínima | Especifica la versión mínima del paquete que desea instalar o desinstalar. |
| Versión máxima | Especifica la versión máxima del paquete que desea instalar o desinstalar. |
| Fuente | Especifica el URI o el nombre del origen del paquete registrado. |
| FuenteCredencial | Proporciona acceso al paquete en una fuente remota. Esta propiedad no se utiliza para instalar el paquete. El paquete siempre se instala en la cuenta del sistema local. |
El recurso PSModule DSC tiene las siguientes propiedades:
| Propiedad | Descripción |
| Nombre | Especifica el nombre del módulo de PowerShell que se instalará o desinstalará. |
| Asegurar | Determina si el módulo se instalará o desinstalará. |
| Política de instalación | Determina si confía en el repositorio de origen donde reside el módulo. |
| Versión requerida | Especifica la versión exacta del módulo que desea instalar o desinstalar. |
| Versión mínima | Especifica la versión mínima del módulo que desea instalar o desinstalar. |
| Repositorio | Especifica el nombre del repositorio de origen del módulo donde se puede encontrar el módulo. |
PackageManagementSource tiene las siguientes propiedades:
| Propiedad | Descripción |
| Nombre | Especifica el nombre del origen del paquete que se registrará o cancelará en su sistema. |
| Nombre del proveedor | Especifica el nombre del proveedor OneGet a través del cual puede interoperar con el origen del paquete. |
| Asegurar | Determina si el origen del paquete se registrará o se cancelará. |
| Política de instalación | Determina si confía en el origen del paquete. |
| FuenteUri | Especifica el URI del origen del paquete. |
| FuenteCredencial | Proporciona acceso al paquete en una fuente remota. |
Antes de instalar este paquete, debe ejecutar [Windows Management Framework 5.0 RTM (https://www.microsoft.com/en-us/download/details.aspx?id=50395).
Para utilizar el módulo PackageManagementProviderResource ,
Para confirmar la instalación,
El código es un script de Windows PowerShell y lo interpreta el motor de Windows PowerShell en tiempo de ejecución.
Para probar los módulos, ejecute los siguientes comandos. El recurso NuGetPackage se utiliza aquí como ejemplo.
Puede repetir estos comandos de manera similar para probar los recursos DSC de PackageManagement, PSModule y PackageManagementSource.
Eres bienvenido a contribuir a este proyecto. Hay muchas maneras de contribuir:
Envíe un informe de error a través de Problemas. Para obtener una guía para enviar buenos informes de errores, lea Painless Bug Tracking.
Verificar correcciones de errores.
Envíe sus correcciones para un error. Antes de enviar, asegúrese de tener:
También puede leer estas dos publicaciones de blog sobre la contribución de código: Etiqueta de contribución de código abierto de Miguel de Icaza y No “empuje” sus solicitudes de extracción de Ilya Grigorik.
Antes de enviar una característica o una contribución sustancial de código, analícela con el equipo de Windows PowerShell a través de Problemas y asegúrese de que siga la hoja de ruta del producto. Tenga en cuenta que todos los envíos de código serán revisados rigurosamente por el equipo de Windows PowerShell. Solo aquellos que cumplan con un estándar alto tanto de calidad como de ajuste a la hoja de ruta se fusionarán en la fuente.
#### Ejemplos ####
Los ejemplos se incluyen en la carpeta Ejemplos.
