Freigeben über

Erste Schritte mit dem PowerShell-Katalog

Der PowerShell-Katalog ist ein Paket-Repository mit Skripts, Modulen und DSC-Ressourcen, die Sie herunterladen und nutzen können. Sie verwenden die Cmdlets im PowerShellGet Modul, um Pakete aus dem PowerShell-Katalog zu installieren. Sie müssen sich nicht anmelden, um Elemente aus dem PowerShell-Katalog herunterzuladen.

Anmerkung

Es ist möglich, ein Paket direkt aus dem PowerShell-Katalog herunterzuladen, dies ist jedoch kein empfohlener Ansatz. Weitere Informationen finden Sie unter manuellen Paketdownload.

Sie finden Pakete im PowerShell-Katalog mithilfe des Steuerelements Suche auf der Homepage des PowerShell-Katalogs, oder navigieren Sie über die Seite Paketedurch die Module und Skripts. Sie können auch Pakete aus dem PowerShell-Katalog finden, indem Sie die Cmdlets Find-Module, Find-DscResourceund Find-Script, je nach Pakettyp, mit -Repository PSGalleryausführen.

Sie können Ergebnisse aus dem Katalog mithilfe der folgenden Parameter filtern:

  • Name
  • AllVersions
  • MinimumVersion
  • RequiredVersion
  • Etikett
  • Enthält
  • DscResource
  • RoleCapability
  • Befehl
  • Filter

Wenn Sie nur an der Ermittlung bestimmter DSC-Ressourcen im Katalog interessiert sind, können Sie das cmdlet Find-DscResource ausführen. Find-DscResource gibt Daten zu DSC-Ressourcen zurück, die im Katalog enthalten sind. Da DSC-Ressourcen immer als Teil eines Moduls bereitgestellt werden, müssen Sie weiterhin Install-Module ausführen, um diese DSC-Ressourcen zu installieren.

Nachdem Sie ein Paket identifiziert haben, an dem Sie interessiert sind, sollten Sie mehr darüber erfahren. Sie können dies tun, indem Sie die spezifische Seite dieses Pakets im Katalog untersuchen. Auf dieser Seite können Sie alle Metadaten anzeigen, die mit dem Paket hochgeladen wurden. Diese Metadaten werden vom Autor des Pakets bereitgestellt und von Microsoft nicht überprüft. Der Besitzer des Pakets ist stark an das Katalogkonto gebunden, das zum Veröffentlichen des Pakets verwendet wird, und ist vertrauenswürdiger als das Feld "Autor".

Wenn Sie ein Paket entdecken, das Sie nicht im guten Glauben veröffentlicht haben, klicken Sie auf der Seite dieses Pakets auf Missbrauch melden.

Wenn Sie Find-Module oder Find-Scriptausführen, können Sie diese Daten im zurückgegebenen PSGetModuleInfo--Objekt anzeigen. Im folgenden Beispiel werden Daten für das PSReadLine Modul im Katalog zurückgegeben.

Find-Module -Name PSReadLine -Repository PSGallery | Get-Member

Wir empfehlen den folgenden Prozess beim Herunterladen von Paketen aus dem PowerShell-Katalog:

Inspizieren

Um ein Paket aus dem Katalog zur Überprüfung herunterzuladen, führen Sie je nach Pakettyp entweder das Save-Module- oder Save-Script-Cmdlet aus. Auf diese Weise können Sie das Paket lokal speichern, ohne es zu installieren, und den Paketinhalt überprüfen. Denken Sie daran, das gespeicherte Paket manuell zu löschen.

Einige dieser Pakete werden von Microsoft erstellt, und andere werden von der PowerShell-Community erstellt. Microsoft empfiehlt, die Inhalte und den Code von Paketen in diesem Katalog vor der Installation zu überprüfen.

Wenn Sie ein Paket entdecken, das Sie nicht im guten Glauben veröffentlicht haben, klicken Sie auf der Seite dieses Pakets auf Missbrauch melden.

Installieren

Um ein Paket aus dem Katalog zur Verwendung zu installieren, führen Sie je nach Pakettyp entweder das Install-Module- oder Install-Script-Cmdlet aus.

Install-Module installiert das Modul standardmäßig auf $env:ProgramFiles\WindowsPowerShell\Modules. Dies erfordert ein Administratorkonto. Wenn Sie den parameter -Scope CurrentUser hinzufügen, wird das Modul auf $HOME\Documents\WindowsPowerShell\Modules installiert.

Install-Script installiert das Skript standardmäßig auf $env:ProgramFiles\WindowsPowerShell\Scripts. Dies erfordert ein Administratorkonto. Wenn Sie den parameter -Scope CurrentUser hinzufügen, wird das Skript zum $HOME\Documents\WindowsPowerShell\Scripts installiert.

Standardmäßig installiert Install-Module und Install-Script die neueste Version eines Pakets. Um eine ältere Version des Pakets zu installieren, fügen Sie den parameter -RequiredVersion hinzu.

Aufstellen

Um ein Paket aus dem PowerShell-Katalog in Azure Automation bereitzustellen, klicken Sie auf Azure Automation, und klicken Sie dann auf der Seite mit den Paketdetails auf auf Bereitstellen in Azure Automation. Sie werden an das Azure-Verwaltungsportal umgeleitet, in dem Sie sich mit Ihren Azure-Kontoanmeldeinformationen anmelden. Beachten Sie, dass das Bereitstellen von Paketen mit Abhängigkeiten alle Abhängigkeiten in Azure Automation bereitstellt. Die Schaltfläche "In Azure Automation bereitstellen" kann durch Hinzufügen des AzureAutomationNotSupported- Tags zu Den Paketmetadaten deaktiviert werden.

Weitere Informationen zu Azure Automation finden Sie in der dokumentation Azure Automation.

Um Pakete zu aktualisieren, die aus dem PowerShell-Katalog installiert sind, führen Sie entweder das cmdlet Update-Module oder Update-Script aus. Wenn sie ohne zusätzliche Parameter ausgeführt wird, versucht Update-Module, alle module zu aktualisieren, die durch Ausführen von Install-Moduleinstalliert wurden. Um Module selektiv zu aktualisieren, fügen Sie den parameter -Name hinzu.

Ebenso versucht Update-Script, alle skripts zu aktualisieren, die ohne zusätzliche Parameter ausgeführt werden, indem Install-Scriptausgeführt wird. Um Skripts selektiv zu aktualisieren, fügen Sie den parameter -Name hinzu.

Um herauszufinden, welche Module Sie aus dem PowerShell-Katalog installiert haben, führen Sie das cmdlet Get-InstalledModule aus. Dieser Befehl listet alle Module auf, die Sie auf Ihrem System haben, die direkt aus dem PowerShell-Katalog installiert wurden.

Um herauszufinden, welche Skripts Sie aus dem PowerShell-Katalog installiert haben, führen Sie das Cmdlet Get-InstalledScript aus. Dieser Befehl listet alle Skripts auf, die Sie auf Ihrem System haben, die direkt aus dem PowerShell-Katalog installiert wurden.

Wichtig

Für den PowerShell-Katalog ist Transport Layer Security (TLS) 1.2 oder höher erforderlich. Wenn Sie TLS 1.2 oder höher nicht verwenden, wird beim Versuch, auf den PowerShell-Katalog zuzugreifen, eine Fehlermeldung angezeigt. Verwenden Sie den folgenden Befehl, um sicherzustellen, dass Sie TLS 1.2 verwenden:

[Net.ServicePointManager]::SecurityProtocol =
    [Net.ServicePointManager]::SecurityProtocol -bor [Net.SecurityProtocolType]::Tls12

Diese Hostnamen sollten den Zulassungslisten hinzugefügt werden, die den Zugriff über Ihr Netzwerk steuern.

Hosts, die für die Paketermittlung und den Download erforderlich sind:

  • cdn.oneget.org
  • cdn.powershellgallery.com

Hosts erforderlich, wenn Sie die PowerShell-Katalogwebsite verwenden:

  • *.powershellgallery.com - Website
  • go.microsoft.com und aka.ms – Umleitungsdienste

Anmerkung

Diese Endpunkte haben sich geändert. Die alten Endpunkte, die mit azureedge.net endeten, werden nicht mehr unterstützt.

  • Last updated on