Announcement
Dieses Repo ist veraltet. Das PackageManagementProviderResource-Modul wurde mit PackageManagement zusammengeführt. Bitte verwenden Sie in Zukunft https://github.com/OneGet/oneget. Danke schön!
Die PackageManagementProviderResource sind die DSC-Ressourcen für PackageManagement-Anbieter (auch bekannt als OneGet). Derzeit enthält es die DSC-Ressourcen des Nuget- und PowerShellGet-Anbieters, mit denen Sie Pakete und Windows PowerShell-Module verwalten können.
Bitte schauen Sie sich die allgemeinen Richtlinien für die Bereitstellung von DSC-Ressourcen an.
PackageManagement – Ein generischer PackageManagement-Anbieter, mit dem Sie Pakete aus beliebigen Quellen herunterladen und installieren können. Dieser Anbieter verwendet die Cmdlets „Install-Package“ und „Get-Package“. Möglicherweise müssen Sie die DSC-Ressource PackageManagementSource verwenden, um nicht standardmäßige Quellen zu registrieren.
NugetPackage – ermöglicht das Herunterladen von Paketen vom NuGet-Quellspeicherort (z. B. http://nuget.org/api/v2/) und das Installieren oder Deinstallieren des Pakets.
PSModule – ermöglicht Ihnen das Herunterladen von Windows PowerShell-Modulen aus der PowerShell-Galerie „PSGallery“ (z. B. https://www.powershellgallery.com/api/v2/) und die Installation auf Ihrem Computer.
PackageManagementSource – ermöglicht Ihnen die Registrierung oder Aufhebung der Registrierung einer Paketquelle auf Ihrem Computer
Die DSC-Ressource „PackageManagement“ weist die folgenden Eigenschaften auf:
| Eigentum | Beschreibung |
| Name | Gibt den Namen des Pakets an, das installiert oder deinstalliert werden soll. |
| Quelle | Gibt den Namen der Paketquelle an, in der das Paket gefunden werden kann. Dies kann entweder ein URI oder eine mit dem Cmdlet Register-PackageSource oder der DSC-Ressource PackageManagementSource registrierte Quelle sein. Die DSC-Ressource MSFT_PackageManagementSource kann auch eine Paketquelle registrieren. |
| Sicherstellen | Legt fest, ob das Paket installiert oder deinstalliert werden soll. |
| ErforderlicheVersion | Gibt die genaue Version des Pakets an, das Sie installieren möchten. Wenn Sie diesen Parameter nicht angeben, installiert diese DSC-Ressource die neueste verfügbare Version des Pakets, die auch jede durch den MaximumVersion-Parameter angegebene maximale Version erfüllt. |
| MinimumVersion | Gibt die minimal zulässige Version des Pakets an, das Sie installieren möchten. Wenn Sie diesen Parameter nicht hinzufügen, installiert diese DSC-Ressource die höchste verfügbare Version des Pakets, die auch alle durch den MaximumVersion-Parameter angegebenen Höchstversionen erfüllt. |
| MaximumVersion | Gibt die maximal zulässige Version des Pakets an, das Sie installieren möchten. Wenn Sie diesen Parameter nicht angeben, installiert diese DSC-Ressource die verfügbare Version des Pakets mit der höchsten Nummer. |
| SourceCredential | Gibt ein Benutzerkonto an, das über Rechte zum Installieren eines Pakets für einen angegebenen Paketanbieter oder eine angegebene Paketquelle verfügt. |
| Anbietername | Gibt den Namen eines Paketanbieters an, auf den Ihre Paketsuche beschränkt werden soll. Sie können Paketanbieternamen abrufen, indem Sie das Cmdlet Get-PackageProvider ausführen. |
| Zusätzliche Parameter | Anbieterspezifische Parameter, die als Hashtable übergeben werden. Beispielsweise können Sie für den NuGet-Anbieter zusätzliche Parameter wie DestinationPath übergeben. |
Die NugetPackage- DSC-Ressource verfügt über die folgenden Eigenschaften:
| Eigentum | Beschreibung |
| Name | Gibt den Namen des Pakets an, das installiert oder deinstalliert werden soll. |
| Zielpfad | Gibt einen Dateispeicherort an, an dem das Paket installiert werden soll. |
| Sicherstellen | Legt fest, ob das Paket installiert oder deinstalliert werden soll. |
| Installationsrichtlinie | Bestimmt, ob Sie der Quelle des Pakets vertrauen. |
| ErforderlicheVersion | Gibt die genaue Version des Pakets an, das Sie installieren oder deinstallieren möchten. |
| MinimumVersion | Gibt die Mindestversion des Pakets an, das Sie installieren oder deinstallieren möchten. |
| MaximumVersion | Gibt die maximale Version des Pakets an, das Sie installieren oder deinstallieren möchten. |
| Quelle | Gibt den URI oder Namen der registrierten Paketquelle an. |
| SourceCredential | Bietet Zugriff auf das Paket auf einer Remotequelle. Diese Eigenschaft wird nicht zur Installation des Pakets verwendet. Das Paket wird immer auf dem lokalen Systemkonto installiert. |
Die PSModule DSC-Ressource hat die folgenden Eigenschaften:
| Eigentum | Beschreibung |
| Name | Gibt den Namen des PowerShell-Moduls an, das installiert oder deinstalliert werden soll. |
| Sicherstellen | Legt fest, ob das Modul installiert oder deinstalliert werden soll. |
| Installationsrichtlinie | Bestimmt, ob Sie dem Quell-Repository vertrauen, in dem sich das Modul befindet. |
| ErforderlicheVersion | Gibt die genaue Version des Moduls an, das Sie installieren oder deinstallieren möchten. |
| MinimumVersion | Gibt die Mindestversion des Moduls an, das Sie installieren oder deinstallieren möchten. |
| Repository | Gibt den Namen des Modulquell-Repositorys an, in dem das Modul gefunden werden kann. |
PackageManagementSource verfügt über die folgenden Eigenschaften:
| Eigentum | Beschreibung |
| Name | Gibt den Namen der Paketquelle an, die auf Ihrem System registriert oder die Registrierung aufgehoben werden soll. |
| Anbietername | Gibt den Namen des OneGet-Anbieters an, über den Sie mit der Paketquelle interagieren können. |
| Sicherstellen | Legt fest, ob die Paketquelle registriert oder nicht registriert werden soll. |
| Installationsrichtlinie | Bestimmt, ob Sie der Paketquelle vertrauen. |
| SourceUri | Gibt den URI der Paketquelle an. |
| SourceCredential | Bietet Zugriff auf das Paket auf einer Remotequelle. |
Bevor Sie dieses Paket installieren, müssen Sie [Windows Management Framework 5.0 RTM(https://www.microsoft.com/en-us/download/details.aspx?id=50395) ausführen.
Um das PackageManagementProviderResource -Modul zu verwenden,
Um die Installation zu bestätigen,
Der Code ist ein Windows PowerShell-Skript und wird zur Laufzeit von der Windows PowerShell-Engine interpretiert.
Führen Sie die folgenden Befehle aus, um die Module zu testen. Als Beispiel wird hier die Ressource NuGetPackage verwendet.
Sie können diese Befehle auf ähnliche Weise wiederholen, um die DSC-Ressourcen PackageManagement, PSModule und PackageManagementSource zu testen.
Sie sind herzlich eingeladen, zu diesem Projekt beizutragen. Es gibt viele Möglichkeiten, einen Beitrag zu leisten:
Senden Sie einen Fehlerbericht über Probleme. Eine Anleitung zum Einreichen guter Fehlerberichte finden Sie unter Painless Bug Tracking.
Überprüfen Sie die Fehlerbehebungen auf Fehler.
Senden Sie Ihre Fehlerbehebungen für einen Fehler. Bitte stellen Sie vor dem Absenden sicher, dass Sie über Folgendes verfügen:
Sie können auch diese beiden Blog-Beiträge zum Beitragen von Code lesen: „Open Source Contribution Etiquette“ von Miguel de Icaza und „Don't „Push“ Your Pull Requests“ von Ilya Grigorik.
Bevor Sie eine Funktion oder einen wesentlichen Codebeitrag einreichen, besprechen Sie diese bitte mit dem Windows PowerShell-Team über Probleme und stellen Sie sicher, dass sie der Produkt-Roadmap entsprechen. Beachten Sie, dass alle Codeübermittlungen vom Windows PowerShell-Team gründlich überprüft werden. Nur diejenigen, die sowohl hinsichtlich der Qualität als auch der Roadmap-Passform hohe Anforderungen erfüllen, werden in die Quelle eingefügt.
#### Beispiele ####
Beispiele sind im Beispielordner enthalten.
