Find-RoleCapability

Referenz

Modul:: PowerShellGet

Sucht nach Rollenfunktionen in Modulen.

Syntax

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>]

Beschreibung

Das Find-RoleCapability Cmdlet durchsucht registrierte Repositorys, um nach PowerShell-Rollenfunktionen und -modulen zu suchen.

Für jede von Find-RoleCapabilitygefundene Rollenfunktion wird ein PSGetRoleCapabilityInfo-Objekt zurückgegeben. PSGetRoleCapabilityInfo-Objekte können über die Pipeline an die Install-Module Cmdlets oder Save-Module gesendet werden.

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

Beispiele

Beispiel 1: Suchen nach Rollenfunktionen

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

Beispiel 2: Suchen nach Rollenfunktionen nach Name

Find-RoleCapability findet Rollenfunktionen nach Name. 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

Beispiel 3: Suchen und Speichern des Moduls einer Rollenfunktion

Das Find-RoleCapability Cmdlet findet eine Rollenfunktion und sendet das Objekt in der 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 Rollenfunktion 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.

Beispiel 4: Suchen und Installieren des Moduls einer Rollenfunktion

Find-RoleCapability findet das Modul und sendet das Objekt in 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 Rollenfunktion General-Lev1 anzugeben. Das Objekt wird an die Pipeline gesendet. Install-Moduleverwendet den Parameter Verbose, um status Nachrichten während der Installation anzuzeigen. Nach Abschluss der Installation bestätigt die Get-InstalledModule Ausgabe, dass das JeaExamples-Modul installiert wurde.

Parameter

-AllowPrerelease

Enthält Ressourcen, die als Vorabversion in den Ergebnissen gekennzeichnet sind.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-AllVersions

Gibt an, dass dieses Cmdlet alle Versionen eines Moduls abruft. Der AllVersions-Parameter zeigt die verfügbaren Versionen eines Moduls an.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Filter

Sucht Ressourcen basierend auf der Suchsyntax des PackageManagement-Anbieters . Geben Sie beispielsweise Wörter an, nach der in den Eigenschaften ModuleName und Description gesucht werden soll.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-MaximumVersion

Gibt die maximale Version des Moduls an, die in die Ergebnisse eingeschlossen werden soll. Die Parameter MaximumVersion und RequiredVersion können nicht im gleichen Befehl verwendet werden.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-MinimumVersion

Gibt die Mindestversion des Moduls an, die in die Ergebnisse eingeschlossen werden soll. Die Parameter MinimumVersion und RequiredVersion können nicht im gleichen Befehl verwendet werden.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ModuleName

Gibt den Namen des Moduls an, in dem nach Rollenfunktionen gesucht werden soll. Der Standardwert sind alle Module.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Name

Gibt den Namen einer Rollenfunktion an. Der Standardwert sind alle Rollenfunktionen. Verwenden Sie Kommas, um ein Array von Ressourcennamen zu trennen.

Type:	String[]
Position:	0
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Proxy

Gibt einen Proxyserver für die Anforderung anstelle einer direkten Verbindung mit der Internetressource an.

Type:	Uri
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-ProxyCredential

Gibt ein Benutzerkonto mit der Berechtigung zum Verwenden des Proxyservers an, der im Proxyparameter angegeben ist.

Type:	PSCredential
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-Repository

Gibt ein Repository an, um nach Rollenfunktionen zu suchen. Verwenden Sie Kommas, um ein Array von Repositorynamen zu trennen.

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-RequiredVersion

Gibt die genaue Versionsnummer des Moduls an, die in die Ergebnisse aufgenommen werden soll. Die Parameter RequiredVersion und MinimumVersion können nicht im gleichen Befehl verwendet werden.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Tag

Gibt Tags an, die Module in einem Repository kategorisieren. Verwenden Sie Kommas, um ein Array von Tags zu trennen.

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

Eingaben

Uri

PSCredential

Ausgaben

PSGetRoleCapabilityInfo

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

Hinweise

Wichtig

Ab April 2020 unterstützt der PowerShell-Katalog die TLS-Versionen (Transport Layer Security) 1.0 und 1.1 nicht mehr. Wenn Sie nicht TLS 1.2 oder höher verwenden, erhalten Sie beim Versuch des Zugriffs auf den PowerShell-Katalog eine Fehlermeldung. Mit dem folgenden Befehl können Sie sicherstellen, dass Sie TLS 1.2 verwenden:

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

Weitere Informationen finden Sie im PowerShell-Blog in der Ankündigung.

Find-RoleCapability

Syntax

Beschreibung

Beispiele

Beispiel 1: Suchen nach Rollenfunktionen

Beispiel 2: Suchen nach Rollenfunktionen nach Name

Beispiel 3: Suchen und Speichern des Moduls einer Rollenfunktion

Beispiel 4: Suchen und Installieren des Moduls einer Rollenfunktion

Parameter

-AllowPrerelease

-AllVersions

-Filter

-MaximumVersion

-MinimumVersion

-ModuleName

-Name

-Proxy

-ProxyCredential

-Repository

-RequiredVersion

-Tag

Eingaben

Ausgaben

Hinweise

Feedback

Zusätzliche Ressourcen

Find-RoleCapability

Syntax

Beschreibung

Beispiele

Beispiel 1: Suchen nach Rollenfunktionen

Beispiel 2: Suchen nach Rollenfunktionen nach Name

Beispiel 3: Suchen und Speichern des Moduls einer Rollenfunktion

Beispiel 4: Suchen und Installieren des Moduls einer Rollenfunktion

Parameter

-AllowPrerelease

-AllVersions

-Filter

-MaximumVersion

-MinimumVersion

-ModuleName

-Name

-Proxy

-ProxyCredential

-Repository

-RequiredVersion

-Tag

Eingaben

Ausgaben

Hinweise

Ähnliche Themen

Feedback

Zusätzliche Ressourcen