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.
För varje modul som hittas av Find-DscResourcereturneras ett PSGetDscResourceInfo- objekt.
PSGetDscResourceInfo objekt kan skickas ned i pipelinen till cmdleten Install-Module.
Install-Module installerar modulen.
Exempel
Exempel 1: Hitta alla DSC-resurser
Find-DscResource returnerar DSC-resurser från registrerade lagringsplatser. Om du vill söka på en specifik lagringsplats använder du parametern 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
Exempel 2: 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 3: 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.
Exempel 4: Hitta alla DSC-resurser i en modul
Find-DscResource hittar alla DSC-resurser som finns i en angiven modul. Som standard visas den aktuella versionen. Om du vill visa andra versioner använder du parametrarna AllVersions eller 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 använder parametern ModuleName för att ange xWebAdministration och hitta DSC-resurserna i modulen. Den aktuella versionen av varje resurs visas.
Exempel 5: Hitta en DSC-resurs efter tagg och nödvändig version
DSC-resurser kan hittas med hjälp av parametrarna Tag och RequiredVersion. Tag visar den aktuella versionen av varje resurs som innehåller den angivna taggen på lagringsplatsen. RequiredVersion behöver parametern ModuleName och parametern Name är valfri. Parametrarna Name och ModuleName begränsar utdata. Använd parametern AllVersions för att visa en DSC-resurss tillgängliga versioner.
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
Exempel 6: Hitta en resurs med hjälp av ett filter
Find-DscResource hittar alla resurser och använder parametern Filter för att ange resultatet efter Domain. Parametern Filter hittar filtervärdet i objektets beskrivning eller modulnamn. Använd cmdleten Select-Object för att visa ett objekts egenskaper.
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
Parametrar
-AllowPrerelease
Innehåller resurser som markerats som en förhandsversion i resultatet.
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
Parametern AllVersions visar var och en av en DSC-resurss tillgängliga versioner. Du kan inte använda parametern AllVersions med parametrarna MinimumVersion, MaximumVersioneller RequiredVersion.
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
Hittar resurser baserat på PackageManagement providerns söksyntax. Ange till exempel ord att söka efter i egenskaperna ModuleName och Description.
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
Anger den maximala versionen av resursen som ska inkluderas i resultatet. Parametrarna MaximumVersion och RequiredVersion kan inte användas i samma kommando.
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
Anger den lägsta versionen av resursen som ska inkluderas i resultatet. Parametrarna MinimumVersion och parametrarna RequiredVersion kan inte användas i samma kommando.
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
Anger en modul som innehåller DSC-resursen.
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.
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
Anger en proxyserver för begäran i stället för en direktanslutning till Internetresursen.
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
Anger ett användarkonto med behörighet att använda proxyservern som anges i proxyparametern.
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
Anger modulens exakta versionsnummer som ska inkluderas i resultatet. Parametrarna RequiredVersion och parametrarna MinimumVersion kan inte användas i samma kommando.
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
Anger taggar som kategoriserar moduler i en lagringsplats. Använd kommatecken för att avgränsa en matris med taggar.
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
Viktigt!
Från och med april 2020 stöder PowerShell-galleriet inte längre TLS-versionerna (Transport Layer Security) 1.0 och 1.1. Om du inte använder TLS 1.2 eller senare får du ett felmeddelande när du försöker komma åt PowerShell-galleriet. Använd följande kommando för att se till att du använder TLS 1.2:
[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
Mer information finns i meddelande i PowerShell-bloggen.
