Find-DscResource
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ě.
Toto je rutina proxy pro tuto rutinu Find-PSResource v modulu Microsoft.PowerShell.PSResourceGet. Další informace naleznete 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. 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 2: 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
Install-Module.
Install-Module pro prostředek nainstaluje modul xWebAdministration.
Parametry
-AllowPrerelease
Zahrne do výsledků prostředky označené jako předběžné verze.
Rutina proxy mapuje tento parametr na parametr Prerelease parametru Find-PSResource.
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
Rutina proxy ignoruje tento parametr, protože není podporován parametrem DscResourceNameParameterSet parametru Find-PSResource.
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
Rutina proxy ignoruje tento parametr, protože není podporován parametrem DscResourceNameParameterSet parametru Find-PSResource.
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
Rutina proxy ignoruje tento parametr, protože není podporován parametrem DscResourceNameParameterSet parametru Find-PSResource.
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
Rutina proxy ignoruje tento parametr, protože není podporován parametrem DscResourceNameParameterSet parametru Find-PSResource.
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
Rutina proxy ignoruje tento parametr, protože není podporován parametrem DscResourceNameParameterSet parametru Find-PSResource.
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.
Rutina proxy mapuje tento parametr na parametr DscResourceName parametru Find-PSResource.
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
Rutina proxy ignoruje tento parametr, protože není podporován parametrem DscResourceNameParameterSet parametru Find-PSResource.
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
Rutina proxy ignoruje tento parametr, protože není podporován parametrem DscResourceNameParameterSet parametru Find-PSResource.
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
Rutina proxy ignoruje tento parametr, protože není podporován parametrem DscResourceNameParameterSet parametru Find-PSResource.
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
Rutina proxy ignoruje tento parametr, protože není podporován parametrem DscResourceNameParameterSet parametru Find-PSResource.
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
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 vyšší. 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
