Find-RoleCapability

Find-RoleCapability
    [[-Name] <String[]>]
    [-ModuleName <String>]
    [-MinimumVersion <String>]
    [-MaximumVersion <String>]
    [-RequiredVersion <String>]
    [-AllVersions]
    [-AllowPrerelease]
    [-Tag <String[]>]
    [-Filter <String>]
    [-Proxy <Uri>]
    [-ProxyCredential <PSCredential>]
    [-Repository <String[]>]
    [<CommonParameters>]

Das Find-RoleCapability Cmdlet durchsucht registrierte Repositorys, um PowerShell-Rollenfunktionen und -module zu finden.

Für jede Rollenfunktion, die von Find-RoleCapability" PSGetRoleCapabilityInfo" gefunden wird, wird ein PSGetRoleCapabilityInfo -Objekt zurückgegeben. PSGetRoleCapabilityInfo-Objekte können an die Install-Module Pipeline Save-Module oder cmdlets gesendet werden.

PowerShell-Rollenfunktionen definieren, welche Befehle und Anwendungen einem Benutzer bei einem JEA-Endpunkt (Just Enough Administration) zur Verfügung stehen. Rollenfunktionen werden durch Dateien mit einer .psrc Erweiterung definiert.

Find-RoleCapability findet Rollenfunktionen in jedem registrierten Repository. Verwenden Sie den Repository-Parameter , um ein bestimmtes Repository zu durchsuchen.

Find-RoleCapability

Name             Version    ModuleName     Repository
----             -------    ----------     ----------
General-Lev1     1.0        JeaExamples    PSGallery
General-Lev2     1.0        JeaExamples    PSGallery
IIS-Lev1         1.0        JeaExamples    PSGallery
IIS-Lev2         1.0        JeaExamples    PSGallery

Find-RoleCapability sucht Rollenfunktionen anhand des Namens. Verwenden Sie Kommas, um ein Array von Namen zu trennen.

Find-RoleCapability -Name General-Lev1, IIS-Lev2

Name             Version    ModuleName     Repository
----             -------    ----------     ----------
General-Lev1     1.0        JeaExamples    PSGallery
IIS-Lev2         1.0        JeaExamples    PSGallery

Das Find-RoleCapability Cmdlet findet eine Rollenfunktion und sendet das Objekt an die Pipeline. Save-Module speichert das Modul der Rollenfunktion in einem Dateisystem. Get-ChildItem zeigt den Inhalt des Modulverzeichnisses an.

PS> Find-RoleCapability -Name General-Lev1 | Save-Module -Path C:\Test\Modules

PS> Get-ChildItem -Path C:\Test\Modules\JeaExamples\1.0\

    Directory: C:\Test\Modules\JeaExamples\1.0

Mode                LastWriteTime         Length Name
----                -------------         ------ ----
d-----          6/4/2019    16:37                RoleCapabilities
-a----          2/5/2019    18:46           1702 CreateRegisterPSSC.ps1
-a----          2/5/2019    18:46           7656 JeaExamples.psd1
-a----         10/1/2018    08:16            595 JeaExamples.psm1

Find-RoleCapability verwendet den Parameter Name , um die Rolle " General-Lev1 " anzugeben. Das Objekt wird an die Pipeline gesendet. Save-Module verwendet den Path-Parameter für den Dateisystemspeicherort, um das Modul zu speichern. Gibt nach dem Speichern Get-ChildItem des Moduls den Pfad des Moduls an und zeigt den Inhalt des Verzeichnisses des JeaExamples-Moduls an.

Find-RoleCapability findet das Modul und sendet das Objekt an die Pipeline. Install-Module installiert das Modul. Verwenden Sie Get-InstalledModule nach der Installation, um die Ergebnisse anzuzeigen.

Find-RoleCapability -Name General-Lev1 | Install-Module -Verbose

VERBOSE: Downloading 'https://www.powershellgallery.com/api/v2/package/JeaExamples/1.0.0'.
VERBOSE: Completed downloading 'https://www.powershellgallery.com/api/v2/package/JeaExamples/1.0.0'.
VERBOSE: Completed downloading 'JeaExamples'.
VERBOSE: InstallPackageLocal' - name='JeaExamples', version='1.0',
VERBOSE: Validating the 'JeaExamples' module contents
VERBOSE: Test-ModuleManifest successfully validated the module manifest file
VERBOSE: Module 'JeaExamples' was installed successfully to path

Get-InstalledModule

Find-RoleCapability verwendet den Parameter Name , um die Rolle " General-Lev1 " anzugeben. Das Objekt wird an die Pipeline gesendet. Install-Module verwendet den Verbose-Parameter , um Statusmeldungen während der Installation anzuzeigen. Nach Abschluss der Installation bestätigt die Get-InstalledModule Ausgabe, dass das JeaExamples-Modul installiert wurde.

Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.

Das Find-RoleCapability Cmdlet gibt ein PSGetRoleCapabilityInfo -Objekt zurück.