Find-DscResource
Söker efter DSC-resurser (Desired State Configuration).
Syntax
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
Cmdleten Find-DscResource söker igenom registrerade lagringsplatser för att hitta DSC-resurser som finns i moduler. Som standard söker Find-DscResource igenom alla registrerade lagringsplatser.
Det här är en proxy-cmdlet för cmdleten Find-PSResource i Microsoft.PowerShell.PSResourceGet. Mer information finns i Find-PSResource.
Exempel
Exempel 1: Hitta en DSC-resurs efter namn
Find-DscResource letar upp DSC-resurser efter namn. Använd kommatecken för att avgränsa en matris med resursnamn.
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 använder parametern Name för att hitta den angivna matrisen med DSC-resurser.
Exempel 2: Hitta en DSC-resurs och installera den
Find-DscResource letar upp en DSC-resurs och skickar objektet nedåt i pipelinen som ska installeras.
Efter installationen använder du Get-InstalledModule för att visa resultatet.
Flera resurser från samma modul kan skickas ned i pipelinen till Install-Module.
Install-Module försöker bara installera modulen en gång.
Find-DscResource -Name xWebsite | Install-Module
Find-DscResource använder parametern Name för att hitta resursen med namnet xWebsite. Objektet skickas ned i pipelinen till cmdleten Install-Module.
Install-Module installerar modulen xWebAdministration för resursen.
Parametrar
-AllowPrerelease
Innehåller resurser som markerats som en förhandsversion i resultatet.
Proxy-cmdleten mappar den här parametern till parametern Prerelease för Find-PSResource.
Parameteregenskaper
| Typ: | SwitchParameter |
| Standardvärde: | None |
| Stöder jokertecken: | False |
| DontShow: | False |
Parameteruppsättningar
(All)
| Position: | Named |
| Obligatorisk: | False |
| Värde från pipeline: | False |
| Värde från pipeline efter egenskapsnamn: | False |
| Värde från återstående argument: | False |
-AllVersions
Proxy-cmdleten ignorerar den här parametern eftersom den inte stöds av DscResourceNameParameterSet för Find-PSResource.
Parameteregenskaper
| Typ: | SwitchParameter |
| Standardvärde: | None |
| Stöder jokertecken: | False |
| DontShow: | False |
Parameteruppsättningar
(All)
| Position: | Named |
| Obligatorisk: | False |
| Värde från pipeline: | False |
| Värde från pipeline efter egenskapsnamn: | False |
| Värde från återstående argument: | False |
-Filter
Proxy-cmdleten ignorerar den här parametern eftersom den inte stöds av DscResourceNameParameterSet för Find-PSResource.
Parameteregenskaper
| Typ: | String |
| Standardvärde: | None |
| Stöder jokertecken: | False |
| DontShow: | False |
Parameteruppsättningar
(All)
| Position: | Named |
| Obligatorisk: | False |
| Värde från pipeline: | False |
| Värde från pipeline efter egenskapsnamn: | False |
| Värde från återstående argument: | False |
-MaximumVersion
Proxy-cmdleten ignorerar den här parametern eftersom den inte stöds av DscResourceNameParameterSet för Find-PSResource.
Parameteregenskaper
| Typ: | String |
| Standardvärde: | None |
| Stöder jokertecken: | False |
| DontShow: | False |
Parameteruppsättningar
(All)
| Position: | Named |
| Obligatorisk: | False |
| Värde från pipeline: | False |
| Värde från pipeline efter egenskapsnamn: | False |
| Värde från återstående argument: | False |
-MinimumVersion
Proxy-cmdleten ignorerar den här parametern eftersom den inte stöds av DscResourceNameParameterSet för Find-PSResource.
Parameteregenskaper
| Typ: | String |
| Standardvärde: | None |
| Stöder jokertecken: | False |
| DontShow: | False |
Parameteruppsättningar
(All)
| Position: | Named |
| Obligatorisk: | False |
| Värde från pipeline: | False |
| Värde från pipeline efter egenskapsnamn: | False |
| Värde från återstående argument: | False |
-ModuleName
Proxy-cmdleten ignorerar den här parametern eftersom den inte stöds av DscResourceNameParameterSet för Find-PSResource.
Parameteregenskaper
| Typ: | String |
| Standardvärde: | None |
| Stöder jokertecken: | False |
| DontShow: | False |
Parameteruppsättningar
(All)
| Position: | Named |
| Obligatorisk: | False |
| Värde från pipeline: | False |
| Värde från pipeline efter egenskapsnamn: | False |
| Värde från återstående argument: | False |
-Name
Anger namnet på en resurs. Standardvärdet är alla resurser. Använd kommatecken för att avgränsa en matris med resursnamn.
Proxy-cmdleten mappar den här parametern till parametern DscResourceName för Find-PSResource.
Parameteregenskaper
| Typ: | String[] |
| Standardvärde: | None |
| Stöder jokertecken: | False |
| DontShow: | False |
Parameteruppsättningar
(All)
| Position: | 0 |
| Obligatorisk: | False |
| Värde från pipeline: | False |
| Värde från pipeline efter egenskapsnamn: | False |
| Värde från återstående argument: | False |
-Proxy
Proxy-cmdleten ignorerar den här parametern eftersom den inte stöds av DscResourceNameParameterSet för Find-PSResource.
Parameteregenskaper
| Typ: | Uri |
| Standardvärde: | None |
| Stöder jokertecken: | False |
| DontShow: | False |
Parameteruppsättningar
(All)
| Position: | Named |
| Obligatorisk: | False |
| Värde från pipeline: | False |
| Värde från pipeline efter egenskapsnamn: | True |
| Värde från återstående argument: | False |
-ProxyCredential
Proxy-cmdleten ignorerar den här parametern eftersom den inte stöds av DscResourceNameParameterSet för Find-PSResource.
Parameteregenskaper
| Typ: | PSCredential |
| Standardvärde: | None |
| Stöder jokertecken: | False |
| DontShow: | False |
Parameteruppsättningar
(All)
| Position: | Named |
| Obligatorisk: | False |
| Värde från pipeline: | False |
| Värde från pipeline efter egenskapsnamn: | True |
| Värde från återstående argument: | False |
-Repository
Anger en lagringsplats för att söka efter resurser. Använd kommatecken för att separera en matris med lagringsplatsnamn.
Parameteregenskaper
| Typ: | String[] |
| Standardvärde: | None |
| Stöder jokertecken: | False |
| DontShow: | False |
Parameteruppsättningar
(All)
| Position: | Named |
| Obligatorisk: | False |
| Värde från pipeline: | False |
| Värde från pipeline efter egenskapsnamn: | False |
| Värde från återstående argument: | False |
-RequiredVersion
Proxy-cmdleten ignorerar den här parametern eftersom den inte stöds av DscResourceNameParameterSet för Find-PSResource.
Parameteregenskaper
| Typ: | String |
| Standardvärde: | None |
| Stöder jokertecken: | False |
| DontShow: | False |
Parameteruppsättningar
(All)
| Position: | Named |
| Obligatorisk: | False |
| Värde från pipeline: | False |
| Värde från pipeline efter egenskapsnamn: | False |
| Värde från återstående argument: | False |
-Tag
Proxy-cmdleten ignorerar den här parametern eftersom den inte stöds av DscResourceNameParameterSet för Find-PSResource.
Parameteregenskaper
| Typ: | String[] |
| Standardvärde: | None |
| Stöder jokertecken: | False |
| DontShow: | False |
Parameteruppsättningar
(All)
| Position: | Named |
| Obligatorisk: | False |
| Värde från pipeline: | False |
| Värde från pipeline efter egenskapsnamn: | False |
| Värde från återstående argument: | False |
CommonParameters
Den här cmdleten stöder vanliga parametrar: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.
Utdata
PSGetDscResourceInfo
Find-DscResource returnerar ett PSGetDscResourceInfo-objekt.
Kommentarer
PowerShell-galleriet stöder inte längre TLS-versionerna (Transport Layer Security) 1.0 och 1.1. Du måste använda TLS 1.2 eller senare. Använd följande kommando för att se till att du använder TLS 1.2:
[Net.ServicePointManager]::SecurityProtocol = [Net.ServicePointManager]::SecurityProtocol -bor [Net.SecurityProtocolType]::Tls12
