Find-DscResource

Riferimento

Modulo:: PowerShellGet

Trova le risorse DSC (Desired State Configuration).

Sintassi

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.

Tipo:	SwitchParameter
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	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 .

Tipo:	SwitchParameter
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	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 .

Tipo:	String
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-MaximumVersion

Specifica la versione massima della risorsa da includere nei risultati. I parametri MaximumVersion e RequiredVersion non possono essere usati nello stesso comando.

Tipo:	String
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-MinimumVersion

Specifica la versione minima della risorsa da includere nei risultati. I parametri MinimumVersion e RequiredVersion non possono essere usati nello stesso comando.

Tipo:	String
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-ModuleName

Specifica un modulo che contiene la risorsa DSC.

Tipo:	String
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	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.

Tipo:	String[]
Posizione:	0
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-Proxy

Specifica un server proxy per la richiesta, anziché una connessione diretta alla risorsa Internet.

Tipo:	Uri
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	True
Accettare caratteri jolly:	False

-ProxyCredential

Specifica un account utente con l'autorizzazione per usare il server proxy specificato nel parametro Proxy .

Tipo:	PSCredential
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	True
Accettare caratteri jolly:	False

-Repository

Specifica un repository in cui cercare le risorse. Usare le virgole per separare una matrice di nomi di repository.

Tipo:	String[]
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	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.

Tipo:	String
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-Tag

Specifica i tag che classificano i moduli in un repository. Usare le virgole per separare una matrice di tag.

Tipo:	String[]
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

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.

Condividi tramite