Find-RoleCapability
Trova le funzionalità del ruolo nei moduli.
Sintassi
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>]
Descrizione
Il Find-RoleCapability cmdlet cerca nei repository registrati di trovare moduli e funzionalità del ruolo di PowerShell.
Per ogni funzionalità del ruolo trovata da Find-RoleCapability, viene restituito un oggetto PSGetRoleCapabilityInfo . Gli oggetti PSGetRoleCapabilityInfo possono essere inviati alla pipeline ai Install-Module cmdlet o Save-Module .
Le funzionalità del ruolo di PowerShell definiscono quali comandi e applicazioni sono disponibili per un utente in un endpoint JEA (Just Enough Administration). Le funzionalità del ruolo sono definite dai file con un'estensione .psrc .
Esempio
Esempio 1: Trovare le funzionalità del ruolo
Find-RoleCapability trova le funzionalità del ruolo in ogni repository registrato. Per eseguire ricerche in un repository specifico, usare il parametro Repository .
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
Esempio 2: Trovare le funzionalità del ruolo in base al nome
Find-RoleCapability trova le funzionalità del ruolo in base al nome. Usare le virgole per separare una matrice di nomi.
Find-RoleCapability -Name General-Lev1, IIS-Lev2
Name Version ModuleName Repository
---- ------- ---------- ----------
General-Lev1 1.0 JeaExamples PSGallery
IIS-Lev2 1.0 JeaExamples PSGallery
Esempio 3: Trovare e salvare il modulo di una funzionalità del ruolo
Il Find-RoleCapability cmdlet trova una funzionalità del ruolo e invia l'oggetto verso il basso nella pipeline.
Save-Module salva il modulo della funzionalità del ruolo in un file system.
Get-ChildItem visualizza il contenuto della directory del modulo.
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 usa il parametro Name per specificare la funzionalità del ruolo General-Lev1 .
L'oggetto viene inviato alla pipeline.
Save-Module usa il parametro Path per il percorso del file system per salvare il modulo. Dopo il salvataggio del modulo, Get-ChildItem specifica il percorso del modulo e visualizza il contenuto della directory del modulo JeaExamples .
Esempio 4: Trovare e installare il modulo di una funzionalità del ruolo
Find-RoleCapability trova il modulo e invia l'oggetto verso il basso nella pipeline.
Install-Module installa il modulo. Dopo l'installazione, usare Get-InstalledModule per visualizzare i risultati.
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 usa il parametro Name per specificare la funzionalità del ruolo General-Lev1 .
L'oggetto viene inviato alla pipeline.
Install-Module usa il parametro Verbose per visualizzare i messaggi di stato durante l'installazione. Al termine dell'installazione, l'output Get-InstalledModule conferma che il modulo JeaExamples è stato installato.
Parametri
-AllowPrerelease
Include le risorse contrassegnate come versione preliminare nei risultati.
Proprietà dei parametri
| Tipo: | SwitchParameter |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-AllVersions
Indica che questo cmdlet ottiene tutte le versioni di un modulo. Il parametro AllVersions visualizza ognuna delle versioni disponibili di un modulo.
Proprietà dei parametri
| Tipo: | SwitchParameter |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-Filter
Trova le risorse in base alla sintassi di ricerca del provider PackageManagement . Ad esempio, specificare le parole da cercare all'interno delle proprietà ModuleName e Description .
Proprietà dei parametri
| Tipo: | String |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-MaximumVersion
Specifica la versione massima del modulo da includere nei risultati. I parametri MaximumVersion e RequiredVersion non possono essere usati nello stesso comando.
Proprietà dei parametri
| Tipo: | String |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-MinimumVersion
Specifica la versione minima del modulo da includere nei risultati. I parametri MinimumVersion e RequiredVersion non possono essere usati nello stesso comando.
Proprietà dei parametri
| Tipo: | String |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-ModuleName
Specifica il nome del modulo in cui cercare le funzionalità del ruolo. Il valore predefinito è tutti i moduli.
Proprietà dei parametri
| Tipo: | String |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-Name
Specifica il nome di una funzionalità del ruolo. Il valore predefinito è tutte le funzionalità del ruolo. Usare le virgole per separare una matrice di nomi di risorse.
Proprietà dei parametri
| Tipo: | String[] |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | 0 |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-Proxy
Specifica un server proxy per la richiesta, anziché una connessione diretta alla risorsa Internet.
Proprietà dei parametri
| Tipo: | Uri |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | True |
| Valore dagli argomenti rimanenti: | False |
-ProxyCredential
Specifica un account utente con l'autorizzazione per usare il server proxy specificato nel parametro Proxy .
Proprietà dei parametri
| Tipo: | PSCredential |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | True |
| Valore dagli argomenti rimanenti: | False |
-Repository
Specifica un repository in cui cercare le funzionalità del ruolo. Usare le virgole per separare una matrice di nomi di repository.
Proprietà dei parametri
| Tipo: | String[] |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-RequiredVersion
Specifica il numero di versione esatto del modulo da includere nei risultati. I parametri RequiredVersion e MinimumVersion non possono essere usati nello stesso comando.
Proprietà dei parametri
| Tipo: | String |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-Tag
Specifica i tag che classificano i moduli in un repository. Usare le virgole per separare una matrice di tag.
Proprietà dei parametri
| Tipo: | String[] |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
CommonParameters
Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedi about_CommonParameters.
Input
Uri
PSCredential
Output
PSGetRoleCapabilityInfo
Il Find-RoleCapability cmdlet restituisce un oggetto PSGetRoleCapabilityInfo .
Note
Importante
A partire da aprile 2020, PowerShell Gallery non supporta più le versioni 1.0 e 1.1 di Transport Layer Security (TLS). Se non si usa TLS 1.2 o versione successiva, si riceverà un errore quando si prova ad accedere a PowerShell Gallery. Usare il comando seguente per assicurarsi di usare TLS 1.2:
[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
Per altre informazioni, vedere l'annuncio nel blog di PowerShell.
