Find-DscResource
Trova le risorse DSC (Desired State Configuration).
Sintassi
All
Find-DscResource
[[-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-DscResource cmdlet cerca nei repository registrati di trovare le risorse DSC contenute nei moduli. Per impostazione predefinita Find-DscResource , esegue ricerche in tutti i repository registrati.
Per ogni modulo trovato da Find-DscResource, viene restituito un oggetto PSGetDscResourceInfo .
Gli oggetti PSGetDscResourceInfo possono essere inviati alla pipeline al Install-Module cmdlet .
Install-Module installa il modulo.
Esempio
Esempio 1: Trovare tutte le risorse DSC
Find-DscResource restituisce le risorse DSC dai repository registrati. Per eseguire ricerche in un repository specifico, usare il parametro Repository .
Find-DscResource
Name Version ModuleName Repository
---- ------- ---------- ----------
Carbon_Privilege 2.8.1 Carbon PSGallery
Carbon_ScheduledTask 2.8.1 Carbon PSGallery
Carbon_Service 2.8.1 Carbon PSGallery
PackageManagement 1.4 PackageManagement PSGallery
PackageManagementSource 1.4 PackageManagement PSGallery
PSModule 2.1.4 PowerShellGet PSGallery
PSRepository 2.1.4 PowerShellGet PSGallery
xArchive 8.7.0.0 xPSDesiredStateConfiguration PSGallery
xDSCWebService 8.7.0.0 xPSDesiredStateConfiguration PSGallery
xEnvironment 8.7.0.0 xPSDesiredStateConfiguration PSGallery
Esempio 2: Trovare una risorsa DSC in base al nome
Find-DscResource individua le risorse DSC in base al nome. Usare le virgole per separare una matrice di nomi di risorse.
Find-DscResource -Name xWebsite, xWebApplication, xWebSiteDefaults
Name Version ModuleName Repository
---- ------- ---------- ----------
xWebApplication 2.6.0.0 xWebAdministration PSGallery
xWebsite 2.6.0.0 xWebAdministration PSGallery
xWebSiteDefaults 2.6.0.0 xWebAdministration PSGallery
Find-DscResource usa il parametro Name per trovare la matrice specificata di risorse DSC.
Esempio 3: Trovare una risorsa DSC e installarla
Find-DscResource individua una risorsa DSC e invia l'oggetto verso il basso nella pipeline da installare.
Dopo l'installazione, usare Get-InstalledModule per visualizzare i risultati.
È possibile inviare più risorse dallo stesso modulo alla pipeline all'oggetto Install-Module.
Install-Module tenta di installare il modulo una sola volta.
Find-DscResource -Name xWebsite | Install-Module
Find-DscResource usa il parametro Name per trovare la risorsa denominata xWebsite. L'oggetto viene inviato alla pipeline al cmdlet Install-Module.
Install-Module installa il modulo xWebAdministration per la risorsa.
Esempio 4: Trovare tutte le risorse DSC in un modulo
Find-DscResource trova tutte le risorse DSC contenute in un modulo specificato. Per impostazione predefinita, viene visualizzata la versione corrente. Per visualizzare altre versioni, usare i parametri AllVersions o RequiredVersions .
Find-DscResource -ModuleName xWebAdministration
Name Version ModuleName Repository
---- ------- ---------- ----------
WebApplicationHandler 2.6.0.0 xWebAdministration PSGallery
xIisFeatureDelegation 2.6.0.0 xWebAdministration PSGallery
xIisHandler 2.6.0.0 xWebAdministration PSGallery
xIisLogging 2.6.0.0 xWebAdministration PSGallery
Find-DscResource usa il parametro ModuleName per specificare xWebAdministration e trovare le risorse DSC contenute nel modulo. Viene visualizzata la versione corrente di ogni risorsa.
Esempio 5: Trovare una risorsa DSC in base al tag e alla versione richiesta
Le risorse DSC possono trovarsi usando i parametri Tag e RequiredVersion. Il tag visualizza la versione corrente di ogni risorsa che contiene il tag specificato nel repository. RequiredVersion richiede il parametro ModuleName e il parametro Name è facoltativo. I parametri Name e ModuleName limitano l'output. Usare il parametro AllVersions per visualizzare le versioni disponibili di una risorsa DSC.
Find-DscResource -ModuleName xWebAdministration -Tag DSC -RequiredVersion 1.20
Name Version ModuleName Repository
---- ------- ---------- ----------
xIisFeatureDelegation 1.20.0.0 xWebAdministration PSGallery
xIisHandler 1.20.0.0 xWebAdministration PSGallery
xIisLogging 1.20.0.0 xWebAdministration PSGallery
xIisMimeTypeMapping 1.20.0.0 xWebAdministration PSGallery
Esempio 6: Trovare una risorsa usando un filtro
Find-DscResource trova tutte le risorse e usa il parametro Filter per specificare i risultati in base al dominio. Il parametro Filter trova il valore del filtro nella descrizione o nel nome del modulo dell'oggetto. Usare il Select-Object cmdlet per visualizzare le proprietà di un oggetto.
Find-DscResource -Filter Domain
Name Version ModuleName Repository
---- ------- ---------- ---------
xComputer 4.1.0.0 xComputerManagement PSGallery
Computer 6.4.0.0 ComputerManagementDsc PSGallery
xDSCDomainjoin 1.1 xDSCDomainjoin PSGallery
xDisk 1.0 xDisk PSGallery
xDSCFirewall 1.6.21 xDSCFirewall PSGallery
dmAwsTagInstance 1.0.1 domainAwsDSCResources PSGallery
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
Il parametro AllVersions visualizza ognuna delle versioni disponibili di una risorsa DSC. Non è possibile usare il parametro AllVersions con i parametri MinimumVersion, MaximumVersion o RequiredVersion .
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 della risorsa 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 della risorsa 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 un modulo che contiene la risorsa DSC.
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 risorsa. Il valore predefinito è tutte le risorse. 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 risorse. 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.
Output
PSGetDscResourceInfo
Find-DscResource restituisce un oggetto PSGetDscResourceInfo .
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.
