Sdílet prostřednictvím

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ě.

Pro každý modul nalezený nástrojem Find-DscResourcese vrátí objekt PSGetDscResourceInfo . Objekty PSGetDscResourceInfo je možné odeslat do kanálu do rutiny Install-Module . Install-Module nainstaluje modul .

Příklady

Příklad 1: Vyhledání všech prostředků DSC

Find-DscResource vrací prostředky DSC z registrovaných úložišť. Pokud chcete vyhledat konkrétní úložiště, použijte parametr 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

Příklad 2: 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 3: 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.

Příklad 4: Vyhledání všech prostředků DSC v modulu

Find-DscResource vyhledá všechny prostředky DSC obsažené v zadaném modulu. Ve výchozím nastavení se zobrazí aktuální verze. Pokud chcete zobrazit jiné verze, použijte parametry AllVersions nebo 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 používá parametr ModuleName k určení xWebAdministration a vyhledání prostředků DSC obsažených v modulu. Zobrazí se aktuální verze jednotlivých prostředků.

Příklad 5: Vyhledání prostředku DSC podle značky a požadované verze

Prostředky DSC je možné najít pomocí parametrů Tag a RequiredVersion. Značka zobrazí aktuální verzi každého prostředku, který obsahuje zadanou značku v úložišti. RequiredVersion potřebuje parametr ModuleName a parametr Name je volitelný. Parametry Name a ModuleName omezují výstup. Pomocí parametru AllVersions zobrazte dostupné verze prostředku 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

Příklad 6: Vyhledání prostředku pomocí filtru

Find-DscResource vyhledá všechny prostředky a pomocí parametru Filter určí výsledky podle domény. Parametr Filter najde hodnotu filtru v popisu objektu nebo názvu modulu. Pomocí rutiny Select-Object zobrazte vlastnosti objektu.

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

Parametry

-AllowPrerelease

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

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

-AllVersions

Parametr AllVersions zobrazuje všechny dostupné verze prostředku DSC. Nemůžete použít parametr AllVersions s parametry MinimumVersion, MaximumVersion nebo RequiredVersion .

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

-Filter

Vyhledá prostředky na základě vyhledávací syntaxe zprostředkovatele PackageManagement . Zadejte například slova, která chcete vyhledat ve vlastnostech ModuleName a Description .

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

-MaximumVersion

Určuje maximální verzi prostředku, který se má zahrnout do výsledků. Parametry MaximumVersion a RequiredVersion nelze použít ve stejném příkazu.

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

-MinimumVersion

Určuje minimální verzi prostředku, který se má zahrnout do výsledků. Parametry MinimumVersion a RequiredVersion nelze použít ve stejném příkazu.

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

-ModuleName

Určuje modul, který obsahuje prostředek DSC.

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.

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

-Proxy

Určuje proxy server pro požadavek, nikoli přímé připojení k internetovému prostředku.

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

-ProxyCredential

Určuje uživatelský účet s oprávněním používat proxy server zadaný v parametru Proxy .

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

Určuje přesné číslo verze modulu, které se má zahrnout do výsledků. Parametry RequiredVersion a MinimumVersion nelze použít ve stejném příkazu.

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

-Tag

Určuje značky, které kategorizují moduly v úložišti. K oddělení pole značek použijte čárky.

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

Důležité

Od dubna 2020 Galerie prostředí PowerShell už nepodporuje protokol TLS (Transport Layer Security) verze 1.0 a 1.1. Pokud nepoužíváte protokol TLS 1.2 nebo novější, při pokusu o přístup k Galerie prostředí PowerShell se zobrazí chyba. Pomocí následujícího příkazu se ujistěte, že používáte protokol TLS 1.2:

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

Další informace najdete v tomto oznámení na blogu o PowerShellu.