Find-RoleCapability
Hittar rollfunktioner i moduler.
Syntax
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
Cmdleten Find-RoleCapability söker igenom registrerade lagringsplatser för att hitta PowerShell-rollfunktioner och -moduler.
För varje rollfunktion som hittas av Find-RoleCapabilityreturneras ett PSGetRoleCapabilityInfo-objekt .
PSGetRoleCapabilityInfo-objekt kan skickas ned i pipelinen Install-Module till cmdletarna eller Save-Module .
PowerShell-rollfunktioner definierar vilka kommandon och program som är tillgängliga för en användare på en JEA-slutpunkt (Just Enough Administration). Rollfunktioner definieras av filer med ett .psrc tillägg.
Exempel
Exempel 1: Hitta rollfunktioner
Find-RoleCapability hittar rollfunktioner i varje registrerad lagringsplats. Om du vill söka efter en specifik lagringsplats använder du parametern Lagringsplats .
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
Exempel 2: Hitta rollfunktioner efter namn
Find-RoleCapability hittar rollfunktioner efter namn. Använd kommatecken för att avgränsa en matris med namn.
Find-RoleCapability -Name General-Lev1, IIS-Lev2
Name Version ModuleName Repository
---- ------- ---------- ----------
General-Lev1 1.0 JeaExamples PSGallery
IIS-Lev2 1.0 JeaExamples PSGallery
Exempel 3: Hitta och spara en rollfunktionsmodul
Cmdleten Find-RoleCapability hittar en rollfunktion och skickar objektet nedåt i pipelinen.
Save-Module sparar rollfunktionens modul i ett filsystem.
Get-ChildItem visar innehållet i modulens katalog.
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 använder parametern Namn för att ange rollfunktionen General-Lev1 .
Objektet skickas ned i pipelinen.
Save-Module använder sökvägsparametern för filsystemplatsen för att spara modulen. När modulen har sparats Get-ChildItem anger du modulens sökväg och visar innehållet i JeaExamples-modulens katalog.
Exempel 4: Hitta och installera en rollfunktionsmodul
Find-RoleCapability hittar modulen och skickar objektet nedåt i pipelinen.
Install-Module installerar modulen. Efter installationen använder du Get-InstalledModule för att se resultatet.
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 använder parametern Namn för att ange rollfunktionen General-Lev1 .
Objektet skickas ned i pipelinen.
Install-Module använder parametern Verbose för att visa statusmeddelanden under installationen. När installationen är klar Get-InstalledModule bekräftar utdata att JeaExamples-modulen har installerats .
Parametrar
-AllowPrerelease
Innehåller resurser som markerats som en förhandsversion i resultatet.
Parameteregenskaper
| Typ: | SwitchParameter |
| Standardvärde: | None |
| Stöder jokertecken: | False |
| DontShow: | False |
Parameteruppsättningar
(All)
| Position: | Named |
| Obligatorisk: | False |
| Värde från pipeline: | False |
| Värde från pipeline efter egenskapsnamn: | False |
| Värde från återstående argument: | False |
-AllVersions
Anger att den här cmdleten hämtar alla versioner av en modul. Parametern AllVersions visar var och en av en moduls tillgängliga versioner.
Parameteregenskaper
| Typ: | SwitchParameter |
| Standardvärde: | None |
| Stöder jokertecken: | False |
| DontShow: | False |
Parameteruppsättningar
(All)
| Position: | Named |
| Obligatorisk: | False |
| Värde från pipeline: | False |
| Värde från pipeline efter egenskapsnamn: | False |
| Värde från återstående argument: | False |
-Filter
Hittar resurser baserat på PackageManagement-providerns söksyntax. Du kan till exempel ange ord att söka efter i egenskaperna ModuleName och Description .
Parameteregenskaper
| Typ: | String |
| Standardvärde: | None |
| Stöder jokertecken: | False |
| DontShow: | False |
Parameteruppsättningar
(All)
| Position: | Named |
| Obligatorisk: | False |
| Värde från pipeline: | False |
| Värde från pipeline efter egenskapsnamn: | False |
| Värde från återstående argument: | False |
-MaximumVersion
Anger den maximala versionen av modulen som ska inkluderas i resultat. Parametrarna MaximumVersion och RequiredVersion kan inte användas i samma kommando.
Parameteregenskaper
| Typ: | String |
| Standardvärde: | None |
| Stöder jokertecken: | False |
| DontShow: | False |
Parameteruppsättningar
(All)
| Position: | Named |
| Obligatorisk: | False |
| Värde från pipeline: | False |
| Värde från pipeline efter egenskapsnamn: | False |
| Värde från återstående argument: | False |
-MinimumVersion
Anger den lägsta versionen av modulen som ska inkluderas i resultatet. Parametrarna MinimumVersion och RequiredVersion kan inte användas i samma kommando.
Parameteregenskaper
| Typ: | String |
| Standardvärde: | None |
| Stöder jokertecken: | False |
| DontShow: | False |
Parameteruppsättningar
(All)
| Position: | Named |
| Obligatorisk: | False |
| Värde från pipeline: | False |
| Värde från pipeline efter egenskapsnamn: | False |
| Värde från återstående argument: | False |
-ModuleName
Anger namnet på modulen där du kan söka efter rollfunktioner. Standardvärdet är alla moduler.
Parameteregenskaper
| Typ: | String |
| Standardvärde: | None |
| Stöder jokertecken: | False |
| DontShow: | False |
Parameteruppsättningar
(All)
| Position: | Named |
| Obligatorisk: | False |
| Värde från pipeline: | False |
| Värde från pipeline efter egenskapsnamn: | False |
| Värde från återstående argument: | False |
-Name
Anger namnet på en rollfunktion. Standardvärdet är alla rollfunktioner. Använd kommatecken för att avgränsa en matris med resursnamn.
Parameteregenskaper
| Typ: | String[] |
| Standardvärde: | None |
| Stöder jokertecken: | False |
| DontShow: | False |
Parameteruppsättningar
(All)
| Position: | 0 |
| Obligatorisk: | False |
| Värde från pipeline: | False |
| Värde från pipeline efter egenskapsnamn: | False |
| Värde från återstående argument: | False |
-Proxy
Anger en proxyserver för begäran i stället för en direktanslutning till Internetresursen.
Parameteregenskaper
| Typ: | Uri |
| Standardvärde: | None |
| Stöder jokertecken: | False |
| DontShow: | False |
Parameteruppsättningar
(All)
| Position: | Named |
| Obligatorisk: | False |
| Värde från pipeline: | False |
| Värde från pipeline efter egenskapsnamn: | True |
| Värde från återstående argument: | False |
-ProxyCredential
Anger ett användarkonto med behörighet att använda proxyservern som anges i proxyparametern.
Parameteregenskaper
| Typ: | PSCredential |
| Standardvärde: | None |
| Stöder jokertecken: | False |
| DontShow: | False |
Parameteruppsättningar
(All)
| Position: | Named |
| Obligatorisk: | False |
| Värde från pipeline: | False |
| Värde från pipeline efter egenskapsnamn: | True |
| Värde från återstående argument: | False |
-Repository
Anger en lagringsplats för att söka efter rollfunktioner. Använd kommatecken för att separera en matris med lagringsplatsnamn.
Parameteregenskaper
| Typ: | String[] |
| Standardvärde: | None |
| Stöder jokertecken: | False |
| DontShow: | False |
Parameteruppsättningar
(All)
| Position: | Named |
| Obligatorisk: | False |
| Värde från pipeline: | False |
| Värde från pipeline efter egenskapsnamn: | False |
| Värde från återstående argument: | False |
-RequiredVersion
Anger modulens exakta versionsnummer som ska inkluderas i resultatet. Parametrarna RequiredVersion och MinimumVersion kan inte användas i samma kommando.
Parameteregenskaper
| Typ: | String |
| Standardvärde: | None |
| Stöder jokertecken: | False |
| DontShow: | False |
Parameteruppsättningar
(All)
| Position: | Named |
| Obligatorisk: | False |
| Värde från pipeline: | False |
| Värde från pipeline efter egenskapsnamn: | False |
| Värde från återstående argument: | False |
-Tag
Anger taggar som kategoriserar moduler i en lagringsplats. Använd kommatecken för att avgränsa en matris med taggar.
Parameteregenskaper
| Typ: | String[] |
| Standardvärde: | None |
| Stöder jokertecken: | False |
| DontShow: | False |
Parameteruppsättningar
(All)
| Position: | Named |
| Obligatorisk: | False |
| Värde från pipeline: | False |
| Värde från pipeline efter egenskapsnamn: | False |
| Värde från återstående argument: | False |
CommonParameters
Den här cmdleten stöder vanliga parametrar: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.
Indata
Uri
PSCredential
Utdata
PSGetRoleCapabilityInfo
Cmdleten Find-RoleCapability returnerar ett PSGetRoleCapabilityInfo-objekt .
Kommentarer
Viktigt!
Från och med april 2020 stöder PowerShell-galleriet inte längre TLS-versionerna (Transport Layer Security) 1.0 och 1.1. Om du inte använder TLS 1.2 eller senare får du ett felmeddelande när du försöker komma åt PowerShell-galleriet. Använd följande kommando för att se till att du använder TLS 1.2:
[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
Mer information finns i meddelande i PowerShell-bloggen.
