Find-DscResource

  • Reference
Modul:
PowerShellGet

Vyhledá prostředky Desired State Configuration (DSC).

Syntax

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>]

Description

Rutina Find-DscResource prohledá registrovaná úložiště a vyhledá prostředky DSC obsažené v modulech. Ve výchozím nastavení Find-DscResource prohledá všechna registrovaná úložiště.

Toto je rutina proxy pro rutinu Find-PSResource v Microsoft.PowerShell.PSResourceGet. Další informace najdete v tématu Find-PSResource.

Příklady

Příklad 1: Vyhledání prostředku DSC podle názvu

Find-DscResource vyhledá prostředky DSC podle názvu. Pole názvů prostředků oddělte čárkami.

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 pomocí parametru Name vyhledá zadané pole prostředků DSC.

Příklad 2: Vyhledání prostředku DSC a jeho instalace

Find-DscResource vyhledá prostředek DSC a odešle objekt do kanálu k instalaci. Po instalaci pomocí příkazu Get-InstalledModule zobrazte výsledky.

Více prostředků ze stejného modulu je možné odeslat kanálem do Install-Module. Install-Module se pokusí nainstalovat modul pouze jednou.

Find-DscResource -Name xWebsite | Install-Module

Find-DscResource pomocí parametru Name vyhledá prostředek s názvem xWebsite. Objekt se odešle do kanálu rutiny Install-Module . Install-Module nainstaluje modul xWebAdministration pro prostředek.

Parametry

-AllowPrerelease

Zahrne prostředky označené jako předběžné verze ve výsledcích.

Rutina proxy serveru mapuje tento parametr na parametr Předběžné verze pro Find-PSResource.

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

-AllVersions

Rutina proxy serveru tento parametr ignoruje, protože ho nepodporuje sada DscResourceNameParameterSet .Find-PSResource

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

-Filter

Rutina proxy serveru tento parametr ignoruje, protože ho nepodporuje sada DscResourceNameParameterSet .Find-PSResource

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

-MaximumVersion

Rutina proxy serveru tento parametr ignoruje, protože ho nepodporuje sada DscResourceNameParameterSet .Find-PSResource

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

-MinimumVersion

Rutina proxy serveru tento parametr ignoruje, protože ho nepodporuje sada DscResourceNameParameterSet .Find-PSResource

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

-ModuleName

Rutina proxy serveru tento parametr ignoruje, protože ho nepodporuje sada DscResourceNameParameterSet .Find-PSResource

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

-Name

Určuje název prostředku. Výchozí hodnota je všechny prostředky. Pole názvů prostředků oddělte čárkami.

Rutina proxy serveru mapuje tento parametr na parametr DscResourceName pro Find-PSResource.

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

-Proxy

Rutina proxy serveru tento parametr ignoruje, protože ho nepodporuje sada DscResourceNameParameterSet .Find-PSResource

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

-ProxyCredential

Rutina proxy serveru tento parametr ignoruje, protože ho nepodporuje sada DscResourceNameParameterSet .Find-PSResource

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

-Repository

Určuje úložiště pro vyhledávání prostředků. K oddělení pole názvů úložišť použijte čárky.

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

-RequiredVersion

Rutina proxy serveru tento parametr ignoruje, protože ho nepodporuje sada DscResourceNameParameterSet .Find-PSResource

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

-Tag

Rutina proxy serveru tento parametr ignoruje, protože ho nepodporuje sada DscResourceNameParameterSet .Find-PSResource

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

Výstupy

PSGetDscResourceInfo

Find-DscResource vrátí OBJEKT PSGetDscResourceInfo .

Poznámky

Galerie prostředí PowerShell už nepodporuje protokol TLS (Transport Layer Security) verze 1.0 a 1.1. Musíte použít protokol TLS 1.2 nebo novější. Pomocí následujícího příkazu se ujistěte, že používáte protokol TLS 1.2:

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