Galerie

Die Gallery ist eine Sammlung vorgefertigter Lösungen für PowerShell Universal. Sie umfasst Ressourcen wie Skripte, Trigger, Apps und Widgets. Sie ist Open-Source, und die Module werden in der PowerShell Gallery veröffentlicht. Die PowerShell Universal Gallery bietet eine gefilterte Liste von Ressourcen, die speziell für die Plattform bestimmt sind.

Ressourcen aus der Gallery installieren

Gallery-Seite

Die Gallery-Seite ermittelt PowerShell Universal-Module in der PowerShell Gallery. Die Ergebnisse werden 5 Minuten zwischengespeichert, um die Leistung zu verbessern.

Um Ressourcen aus der Bibliothek zu installieren, klicken Sie in der Universal Admin Console auf Platform \ Gallery. Klicken Sie auf das Symbol Install, um die Ressource in Ihrer Umgebung zu speichern. Jede Lösung ist ein PowerShell-Modul, das im Modulverzeichnis Ihres Repositorys enthalten sein wird.

Module in der Gallery

Ressourcen, die aus Modulen installiert wurden, wie etwa aus der Gallery, werden in der Admin Console als schreibgeschützt markiert.

Schreibgeschützte Ressource in der Admin Console

Modulseite

Klicken Sie auf der Modulseite auf Galleries und wählen Sie dann PSGallery aus, um Ressourcen direkt aus dem PowerShell Gallery-Feed zu suchen und herunterzuladen. Sie müssen nach dem Tag PowerShellUniversal filtern, um Module zu finden, die speziell für die Plattform bestimmt sind.

Ressourcen deinstallieren

Sobald eine Ressource installiert ist, können Sie sie nicht entfernen, es sei denn, Sie entfernen das Modul selbst. Sie können zur Seite Platform \ Modules navigieren und auf die Registerkarte Repository Modules klicken, um die aus der Bibliothek installierten Module anzuzeigen.

Ein Klick auf das Symbol Delete entfernt das Modul und alle damit verbundenen Ressourcen.

Repository-Module

Zur Gallery beitragen

Sie können eigene Skripte zur PowerShell Universal Gallery beitragen. Die PowerShell Universal Gallery findet automatisch Module in der PowerShell Gallery, die mit PowerShellUniversal getaggt sind. Wenn Ihr Modul in der PowerShell Universal Gallery und in PowerShell Universal erscheinen soll, fügen Sie dieses Tag hinzu.

Nachfolgend finden Sie ein Beispiel für ein Manifest aus dem Repository der PowerShell Universal Gallery. Sie können einen GitHub-Repository-Pfad als ProjectUri im Manifest angeben. Wenn Sie dies tun, wird der Inhalt der Datei README.md auf PowerShellUniversal.com dargestellt.

@{
    ModuleVersion = '1.0.0'
    GUID          = '59f32838-32bb-46e3-b29d-eb360292a8c9'
    Author        = 'Ironman Software'
    CompanyName   = 'Ironman Software'
    Copyright     = '(c) Ironman Software. All rights reserved.'
    Description   = 'Provides API endpoints from querying, creating, deleting and updating CIM instances.'
    PrivateData   = @{
        PSData = @{
            Tags       = @('CIM', "PowerShellUniversal", "api")
            LicenseUri = 'https://github.com/ironmansoftware/scripts/tree/main/LICENSE'
            ProjectUri = 'https://github.com/ironmansoftware/scripts/tree/main/APIs/PowerShellUniversal.API.CIM'
            IconUri    = 'https://raw.githubusercontent.com/ironmansoftware/scripts/main/images/script.png'
        }
    }
}

Lizenzierte Module

Lizenzierte Module befinden sich derzeit in der Vorschau.

Ab PowerShell Universal 5.2 können Sie nun eine PSULicensed-Option im Abschnitt PSData Ihres Modulmanifests angeben. Wenn das Modul lizenziert ist, wird es ohne eine für das zu ladende Modul spezifische Lizenzdatei nicht geladen. Lizenzdateien werden derzeit von Ironman Software manuell für Modulautoren erstellt. Bitte wenden Sie sich für weitere Informationen an den Support von Ironman Software.

@{
    ModuleVersion = '1.0.0'
    GUID          = '59f32838-32bb-46e3-b29d-eb360292a8c9'
    Author        = 'Ironman Software'
    CompanyName   = 'Ironman Software'
    Copyright     = '(c) Ironman Software. All rights reserved.'
    Description   = 'Provides API endpoints from querying, creating, deleting and updating CIM instances.'
    PrivateData   = @{
        PSData = @{
            Tags       = @('CIM', "PowerShellUniversal", "api")
            LicenseUri = 'https://github.com/ironmansoftware/scripts/tree/main/LICENSE'
            ProjectUri = 'https://github.com/ironmansoftware/scripts/tree/main/APIs/PowerShellUniversal.API.CIM'
            IconUri    = 'https://raw.githubusercontent.com/ironmansoftware/scripts/main/images/script.png'
            PSULicensed = $true
        }
    }
}

Wenn ein lizenziertes Modul installiert ist, aber keine Lizenz bereitgestellt wird, lädt PowerShell Universal keine Ressourcen aus dem Modul. Beachten Sie, dass alle generischen PowerShell-Funktionen, -Aliase und -Variablen, die vom Modul bereitgestellt werden, verfügbar sind. Apps, Skripte, APIs oder andere PowerShell Universal-Funktionen werden nicht geladen.

Lizenzierte Module bieten derzeit keinen Mechanismus, um Ihre PowerShell-Skripte zu verschleiern oder Benutzer daran zu hindern, das Lizenzierungs-Flag zu entfernen. Wir empfehlen, eine Standard-EULA beizufügen, um sicherzustellen, dass Benutzer rechtlich dafür verantwortlich sind, wenn sie diese Dateien manipulieren, um die Lizenzierung zu umgehen.