Partager via

Find-RoleCapability

  • Référence
Module:
PowerShellGet

Recherche les capacités de rôle dans des modules.

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

Description

L’applet Find-RoleCapability de commande recherche les référentiels inscrits pour trouver des fonctionnalités et des modules de rôle PowerShell.

Pour chaque fonctionnalité de rôle trouvée par Find-RoleCapability, un objet PSGetRoleCapabilityInfo est retourné. Les objets PSGetRoleCapabilityInfo peuvent être envoyés vers le bas du pipeline aux Install-Module applets de commande ou Save-Module .

Les fonctionnalités de rôle PowerShell définissent les commandes et les applications disponibles pour un utilisateur sur un point de terminaison JeA (Just Enough Administration). Les fonctionnalités de rôle sont définies par les fichiers avec une .psrc extension.

Exemples

Exemple 1 : Rechercher des fonctionnalités de rôle

Find-RoleCapability recherche les fonctionnalités de rôle dans chaque dépôt inscrit. Pour effectuer une recherche dans un référentiel spécifique, utilisez le paramètre Référentiel .

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

Exemple 2 : Rechercher les fonctionnalités de rôle par nom

Find-RoleCapability recherche les fonctionnalités de rôle par nom. Utilisez des virgules pour séparer un tableau de noms.

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

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

Exemple 3 : Rechercher et enregistrer le module d’une fonctionnalité de rôle

L’applet Find-RoleCapability de commande recherche une fonctionnalité de rôle et envoie l’objet dans le pipeline. Save-Module enregistre le module de la fonctionnalité de rôle dans un système de fichiers. Get-ChildItem affiche le contenu du répertoire du module.

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 utilise le paramètre Name pour spécifier la fonctionnalité de rôle General-Lev1 . L’objet est envoyé vers le bas du pipeline. Save-Module utilise le paramètre Path pour l’emplacement du système de fichiers pour enregistrer le module. Une fois le module enregistré, Get-ChildItem spécifie le chemin d’accès du module et affiche le contenu du répertoire du module JeaExamples .

Exemple 4 : Rechercher et installer le module d’une fonctionnalité de rôle

Find-RoleCapability recherche le module et envoie l’objet dans le pipeline. Install-Module installe le module. Après l’installation, utilisez Get-InstalledModule pour afficher les résultats.

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 utilise le paramètre Name pour spécifier la fonctionnalité de rôle General-Lev1 . L’objet est envoyé vers le bas du pipeline. Install-Moduleutilise le paramètre Verbose pour afficher status messages pendant l’installation. Une fois l’installation terminée, la Get-InstalledModule sortie confirme que le module JeaExamples a été installé.

Paramètres

-AllowPrerelease

Inclut des ressources marquées comme une préversion dans les résultats.

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

-AllVersions

Indique que cette applet de commande obtient toutes les versions d’un module. Le paramètre AllVersions affiche chacune des versions disponibles d’un module.

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

-Filter

Recherche des ressources en fonction de la syntaxe de recherche du fournisseur PackageManagement . Par exemple, spécifiez les mots à rechercher dans les propriétés ModuleName et Description .

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

-MaximumVersion

Spécifie la version maximale du module à inclure dans les résultats. Les paramètres MaximumVersion et RequiredVersion ne peuvent pas être utilisés dans la même commande.

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

-MinimumVersion

Spécifie la version minimale du module à inclure dans les résultats. Les paramètres MinimumVersion et RequiredVersion ne peuvent pas être utilisés dans la même commande.

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

-ModuleName

Spécifie le nom du module dans lequel rechercher des fonctionnalités de rôle. La valeur par défaut est tous les modules.

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

-Name

Spécifie le nom d’une fonctionnalité de rôle. La valeur par défaut est toutes les fonctionnalités de rôle. Utilisez des virgules pour séparer un tableau de noms de ressources.

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

-Proxy

Spécifie un serveur proxy pour la demande, plutôt qu’une connexion directe à la ressource Internet.

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

-ProxyCredential

Spécifie un compte d’utilisateur autorisé à utiliser le serveur proxy spécifié dans le paramètre Proxy .

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

-Repository

Spécifie un dépôt pour rechercher des fonctionnalités de rôle. Utilisez des virgules pour séparer un tableau de noms de référentiels.

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

-RequiredVersion

Spécifie le numéro de version exact du module à inclure dans les résultats. Les paramètres RequiredVersion et MinimumVersion ne peuvent pas être utilisés dans la même commande.

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

-Tag

Spécifie les balises qui classent les modules dans un référentiel. Utilisez des virgules pour séparer un tableau de balises.

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

Entrées

Uri

PSCredential

Sorties

PSGetRoleCapabilityInfo

L’applet Find-RoleCapability de commande renvoie un objet PSGetRoleCapabilityInfo .

Notes

Important

Depuis avril 2020, PowerShell Gallery ne prend plus en charge les versions 1.0 et 1.1 de Transport Layer Security (TLS). Si vous n'utilisez pas TLS 1.2 ou une version plus récente, vous recevez une erreur lorsque vous tentez d'accéder à PowerShell Gallery. Utilisez la commande suivante pour vous assurer que vous utilisez TLS 1.2 :

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

Pour plus d’informations, consultez l’annonce sur le blog PowerShell.