Find-DscResource

Modul:

PowerShellGet Module

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

Syntaxe

All

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á zaregistrovaná úložiště a vyhledá prostředky DSC obsažené v modulech. Ve výchozím nastavení Find-DscResource prohledává všechna registrovaná úložiště.

Pro každý modul nalezený Find-DscResourceje vrácen objekt PSGetDscResourceInfo objektu. PSGetDscResourceInfo objekty je možné odeslat kanál do rutiny Install-Module. Install-Module modul nainstaluje.

Příklady

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

Find-DscResource vrátí prostředky DSC z registrovaných úložišť. Pokud chcete prohledat 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. K oddělení pole názvů prostředků použijte čárky.

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 k vyhledání zadaného pole prostředků DSC používá parametr Název.

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

Find-DscResource vyhledá prostředek DSC a odešle objekt do kanálu, který se má nainstalovat. Po instalaci zobrazte výsledky pomocí Get-InstalledModule.

Do Install-Modulelze odeslat více prostředků ze stejného modulu. Install-Module se pokusí nainstalovat modul pouze jednou.

Find-DscResource -Name xWebsite | Install-Module

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

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

Find-DscResource najde 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

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 lze nalézt 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. K zobrazení dostupných verzí prostředku DSC použijte parametr AllVersions.

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 najde všechny prostředky a pomocí parametru Filter určí výsledky podle Domain. Parametr Filter vyhledá hodnotu filtru v popisu objektu nebo v názvu modulu. K zobrazení vlastností objektu použijte rutinu Select-Object.

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 do výsledků prostředky označené jako předběžné verze.

Vlastnosti parametru

Typ:	SwitchParameter
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-AllVersions

Parametr AllVersions zobrazí všechny dostupné verze prostředku DSC. Parametr AllVersions nemůžete použít s parametry MinimumVersion, MaximumVersionnebo RequiredVersion.

Vlastnosti parametru

Typ:	SwitchParameter
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-Filter

Vyhledá prostředky na základě syntaxe vyhledávání poskytovatele PackageManagement. Zadejte například slova, která se mají hledat v ModuleName a Popis vlastnosti.

Vlastnosti parametru

Typ:	String
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-MaximumVersion

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

Vlastnosti parametru

Typ:	String
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	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.

Vlastnosti parametru

Typ:	String
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-ModuleName

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

Vlastnosti parametru

Typ:	String
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-Name

Určuje název prostředku. Výchozí hodnota je všechny prostředky. K oddělení pole názvů prostředků použijte čárky.

Vlastnosti parametru

Typ:	String[]
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	0
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-Proxy

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

Vlastnosti parametru

Typ:	Uri
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

-ProxyCredential

Určuje uživatelský účet s oprávněním k použití proxy serveru zadaného v parametru Proxy .

Vlastnosti parametru

Typ:	PSCredential
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

-Repository

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

Vlastnosti parametru

Typ:	String[]
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	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.

Vlastnosti parametru

Typ:	String
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-Tag

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

Vlastnosti parametru

Typ:	String[]
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

CommonParameters

Tato rutina podporuje běžné parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction a -WarningVariable. Další informace najdete v about_CommonParameters.

Výstupy

PSGetDscResourceInfo

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 vyšší, při pokusu o přístup k galerii 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 oznámení v blogu PowerShellu.

Související odkazy

• Get-InstalledModule
• Install-Module
• Register-PSRepository
• Vybrat-Objekt
• Uninstall-Module