Find-RoleCapability
Recherche les fonctionnalités de rôle dans les modules.
Syntaxe
All
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 rechercher les fonctionnalités et les 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 pipeline vers les applets de commande ou Install-Module les Save-Module applets de commande.
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 référentiel 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 des 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 vers le bas du 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 vers le bas du pipeline.
Install-Module installe le module. Après l’installation, utilisez cette option 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-Module utilise le paramètre Verbose pour afficher les messages d’état 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 les ressources marquées comme une préversion dans les résultats.
Propriétés du paramètre
| Type: | SwitchParameter |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | 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.
Propriétés du paramètre
| Type: | SwitchParameter |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Filter
Recherche les ressources en fonction de la syntaxe de recherche du fournisseur PackageManagement. Par exemple, spécifiez des mots à rechercher dans les propriétés moduleName
Propriétés du paramètre
| Type: | String |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-MaximumVersion
Spécifie la version maximale du module à inclure dans les résultats. Les MaximumVersion
Propriétés du paramètre
| Type: | String |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-MinimumVersion
Spécifie la version minimale du module à inclure dans les résultats. Les MinimumVersion et les paramètres RequiredVersion ne peuvent pas être utilisés dans la même commande.
Propriétés du paramètre
| Type: | String |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | 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.
Propriétés du paramètre
| Type: | String |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | 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.
Propriétés du paramètre
| Type: | String[] |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | 0 |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Proxy
Spécifie un serveur proxy pour la requête, plutôt qu’une connexion directe à la ressource Internet.
Propriétés du paramètre
| Type: | Uri |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | True |
| Valeur des arguments restants: | False |
-ProxyCredential
Spécifie un compte d’utilisateur avec l’autorisation d’utiliser le serveur proxy spécifié dans le paramètre proxy .
Propriétés du paramètre
| Type: | PSCredential |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | True |
| Valeur des arguments restants: | False |
-Repository
Spécifie un référentiel pour rechercher des fonctionnalités de rôle. Utilisez des virgules pour séparer un tableau de noms de référentiels.
Propriétés du paramètre
| Type: | String[] |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-RequiredVersion
Spécifie le numéro de version exact du module à inclure dans les résultats. Les RequiredVersion et les paramètres MinimumVersion ne peuvent pas être utilisés dans la même commande.
Propriétés du paramètre
| Type: | String |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Tag
Spécifie des balises qui classent les modules dans un référentiel. Utilisez des virgules pour séparer un tableau de balises.
Propriétés du paramètre
| Type: | String[] |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
CommonParameters
Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.
Entrées
Uri
PSCredential
Sorties
PSGetRoleCapabilityInfo
L’applet Find-RoleCapability de commande retourne un objet PSGetRoleCapabilityInfo .
Notes
Important
Depuis avril 2020, PowerShell Gallery ne prend plus en charge les versions TLS (Transport Layer Security) 1.0 et 1.1. Si vous n’utilisez pas TLS 1.2 ou version ultérieure, vous recevez une erreur lors de la tentative d’accès à 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 dans le blog PowerShell.