Find-DscResource

  • Riferimento
Modulo:
PowerShellGet

Trova 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 repository registrati per trovare le risorse DSC contenute nei moduli. Per impostazione predefinita, tutti i repository registrati vengono cercati Find-DscResource .

Questo è un cmdlet proxy per il Find-PSResource cmdlet in Microsoft.PowerShell.PSResourceGet. Per altre informazioni, vedere Find-PSResource.

Esempio

Esempio 1: Trovare una risorsa DSC in base al nome

Find-DscResource individua le risorse DSC in base al nome. Usare 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 2: 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 dallo stesso modulo alla pipeline all'oggetto Install-Module. Install-Module tenta di installare solo 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.

Parametri

-AllowPrerelease

Include le risorse contrassegnate come versione preliminare nei risultati.

Il cmdlet proxy esegue il mapping di questo parametro al parametro Prerelease di Find-PSResource.

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

-AllVersions

Il cmdlet proxy ignora questo parametro perché non è supportato da DscResourceNameParameterSet di Find-PSResource.

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

-Filter

Il cmdlet proxy ignora questo parametro perché non è supportato da DscResourceNameParameterSet di Find-PSResource.

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

-MaximumVersion

Il cmdlet proxy ignora questo parametro perché non è supportato da DscResourceNameParameterSet di Find-PSResource.

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

-MinimumVersion

Il cmdlet proxy ignora questo parametro perché non è supportato da DscResourceNameParameterSet di Find-PSResource.

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

-ModuleName

Il cmdlet proxy ignora questo parametro perché non è supportato da DscResourceNameParameterSet di Find-PSResource.

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 virgole per separare una matrice di nomi di risorse.

Il cmdlet proxy esegue il mapping di questo parametro al parametro DscResourceName di Find-PSResource.

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

-Proxy

Il cmdlet proxy ignora questo parametro perché non è supportato da DscResourceNameParameterSet di Find-PSResource.

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

-ProxyCredential

Il cmdlet proxy ignora questo parametro perché non è supportato da DscResourceNameParameterSet di Find-PSResource.

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

-Repository

Specifica un repository per cercare le risorse. Usare 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

Il cmdlet proxy ignora questo parametro perché non è supportato da DscResourceNameParameterSet di Find-PSResource.

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

-Tag

Il cmdlet proxy ignora questo parametro perché non è supportato da DscResourceNameParameterSet di Find-PSResource.

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

La PowerShell Gallery non supporta più Transport Layer Security (TLS) versioni 1.0 e 1.1. È necessario usare TLS 1.2 o versione successiva. Per verificare di usare TLS 1.2, eseguire il comando seguente:

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