Announcement
Ce dépôt est obsolète. Le module PackageManagementProviderResource a été fusionné avec PackageManagement. Veuillez utiliser https://github.com/OneGet/oneget à l'avenir. Merci!
PackageManagementProviderResource correspond aux ressources DSC pour les fournisseurs PackageManagement (alias OneGet). Actuellement, il contient les ressources DSC des fournisseurs Nuget et PowerShellGet pour vous permettre de gérer les packages et les modules Windows PowerShell.
Veuillez consulter les directives communes de contribution aux ressources DSC.
PackageManagement – Un fournisseur générique de PackageManagement qui vous permet de télécharger et d'installer des packages à partir de n'importe quelle source. Ce fournisseur utilise les applets de commande Install-Package et Get-Package. Vous devrez peut-être utiliser la ressource PackageManagementSource DSC pour enregistrer des sources autres que celles par défaut.
NugetPackage – vous permet de télécharger des packages à partir de l'emplacement source de NuGet (par exemple, http://nuget.org/api/v2/) et d'installer ou de désinstaller le package.
PSModule – vous permet de télécharger des modules Windows PowerShell à partir de la galerie PowerShell, « PSGallery » (par exemple, https://www.powershellgallery.com/api/v2/ ), et de les installer sur votre ordinateur.
PackageManagementSource – vous permet d'enregistrer ou de désenregistrer une source de package sur votre ordinateur
La ressource PackageManagement DSC possède les propriétés suivantes :
| Propriété | Description |
| Nom | Spécifie le nom du package à installer ou à désinstaller. |
| Source | Spécifie le nom de la source du package où le package peut être trouvé. Il peut s'agir d'un URI ou d'une source enregistrée avec l'applet de commande Register-PackageSource ou la ressource DSC PackageManagementSource. La ressource DSC MSFT_PackageManagementSource peut également enregistrer une source de package. |
| Assurer | Détermine si le package doit être installé ou désinstallé. |
| Version requise | Spécifie la version exacte du package que vous souhaitez installer. Si vous ne spécifiez pas ce paramètre, cette ressource DSC installe la version disponible la plus récente du package qui satisfait également à toute version maximale spécifiée par le paramètre MaximumVersion. |
| Version minimale | Spécifie la version minimale autorisée du package que vous souhaitez installer. Si vous n'ajoutez pas ce paramètre, cette ressource DSC installe la version disponible la plus élevée du package qui satisfait également à toute version maximale spécifiée par le paramètre MaximumVersion. |
| Version maximale | Spécifie la version maximale autorisée du package que vous souhaitez installer. Si vous ne spécifiez pas ce paramètre, cette ressource DSC installe la version disponible portant le numéro le plus élevé du package. |
| Informations d'identification source | Spécifie un compte utilisateur disposant des droits nécessaires pour installer un package pour un fournisseur ou une source de package spécifié. |
| Nom du fournisseur | Spécifie un nom de fournisseur de packages auquel étendre votre recherche de packages. Vous pouvez obtenir les noms des fournisseurs de packages en exécutant la cmdlet Get-PackageProvider. |
| Paramètres supplémentaires | Paramètres spécifiques au fournisseur qui sont transmis sous forme de table de hachage. Par exemple, pour le fournisseur NuGet, vous pouvez transmettre des paramètres supplémentaires tels que DestinationPath. |
La ressource NugetPackage DSC possède les propriétés suivantes :
| Propriété | Description |
| Nom | Spécifie le nom du package à installer ou à désinstaller. |
| Chemin de destination | Spécifie un emplacement de fichier dans lequel vous souhaitez que le package soit installé. |
| Assurer | Détermine si le package doit être installé ou désinstallé. |
| Politique d'installation | Détermine si vous faites confiance à la source du package. |
| Version requise | Spécifie la version exacte du package que vous souhaitez installer ou désinstaller. |
| Version minimale | Spécifie la version minimale du package que vous souhaitez installer ou désinstaller. |
| Version maximale | Spécifie la version maximale du package que vous souhaitez installer ou désinstaller. |
| Source | Spécifie l'URI ou le nom de la source du package enregistré. |
| Informations d'identification source | Fournit l’accès au package sur une source distante. Cette propriété n'est pas utilisée pour installer le package. Le package est toujours installé sur le compte système local. |
La ressource PSModule DSC possède les propriétés suivantes :
| Propriété | Description |
| Nom | Spécifie le nom du module PowerShell à installer ou à désinstaller. |
| Assurer | Détermine si le module doit être installé ou désinstallé. |
| Politique d'installation | Détermine si vous faites confiance au référentiel source où réside le module. |
| Version requise | Spécifie la version exacte du module que vous souhaitez installer ou désinstaller. |
| Version minimale | Spécifie la version minimale du module que vous souhaitez installer ou désinstaller. |
| Dépôt | Spécifie le nom du référentiel source du module dans lequel le module peut être trouvé. |
PackageManagementSource a les propriétés suivantes :
| Propriété | Description |
| Nom | Spécifie le nom de la source du package à enregistrer ou à désenregistrer sur votre système. |
| Nom du fournisseur | Spécifie le nom du fournisseur OneGet via lequel vous pouvez interagir avec la source du package. |
| Assurer | Détermine si la source du package doit être enregistrée ou non. |
| Politique d'installation | Détermine si vous faites confiance à la source du package. |
| SourceUri | Spécifie l'URI de la source du package. |
| Informations d'identification source | Fournit l’accès au package sur une source distante. |
Avant d'installer ce package, vous devez exécuter [Windows Management Framework 5.0 RTM(https://www.microsoft.com/en-us/download/details.aspx?id=50395).
Pour utiliser le module PackageManagementProviderResource ,
Pour confirmer l'installation,
Le code est un script Windows PowerShell et interprété par le moteur Windows PowerShell au moment de l'exécution.
Pour tester les modules, exécutez les commandes suivantes. La ressource NuGetPackage est utilisée ici à titre d'exemple.
Vous pouvez répéter ces commandes de la même manière pour tester les ressources PackageManagement, PSModule et PackageManagementSource DSC.
Vous êtes invités à contribuer à ce projet. Il existe de nombreuses façons de contribuer :
Soumettez un rapport de bug via Problèmes. Pour un guide sur la soumission de bons rapports de bogues, veuillez lire Painless Bug Tracking.
Vérifiez les correctifs pour les bogues.
Soumettez vos correctifs pour un bug. Avant de soumettre, assurez-vous d'avoir :
Vous pouvez également lire ces deux articles de blog sur la contribution au code : Open Source Contribution Etiquette de Miguel de Icaza et Don't « Push » Your Pull Requests d'Ilya Grigorik.
Avant de soumettre une fonctionnalité ou une contribution substantielle au code, veuillez en discuter avec l'équipe Windows PowerShell via Problèmes et assurez-vous qu'elle suit la feuille de route du produit. Notez que toutes les soumissions de code seront rigoureusement examinées par l'équipe Windows PowerShell. Seuls ceux qui satisfont à la barre haute en termes de qualité et d’adéquation à la feuille de route seront fusionnés dans la source.
#### Exemples ####
Les exemples sont inclus dans le dossier Exemples.
