Condividi tramite

Find-DscResource

  • Riferimento
Modulo:
PowerShellGet

Trova le risorse Desired State Configuration (DSC).

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 , cerca 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 alla pipeline da installare. Dopo l'installazione, usare Get-InstalledModule per visualizzare i risultati.

È possibile inviare più risorse dello 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 Install-Module cmdlet . 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 per tag e versione richiesta

Le risorse DSC possono trovarsi usando i parametri Tag e RequiredVersion. 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.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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 .

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Filter

Trova le risorse in base alla sintassi di ricerca del provider PackageManagement . Ad esempio, specificare le parole da cercare nelle proprietà ModuleName e Description .

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-MaximumVersion

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-MinimumVersion

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ModuleName

Specifica un modulo che contiene la risorsa DSC.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:String[]
Position:0
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Proxy

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

Type:Uri
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ProxyCredential

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

Type:PSCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Repository

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

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Tag

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

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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 TLS (Transport Layer Security). Se non si usa TLS 1.2 o versione successiva, si riceverà un errore quando si tenta di accedere a PowerShell Gallery. Per verificare di usare TLS 1.2, eseguire il comando seguente:

[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12

Per altre informazioni, vedere l'annuncio corrispondente nel blog di PowerShell.