Find-DscResource

Referens

Modul:: PowerShellGet

Söker efter Desired State Configuration(DSC)-resurser.

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

Cmdleten Find-DscResource söker igenom registrerade lagringsplatser för att hitta DSC-resurser som finns i moduler. Som standard Find-DscResource söker 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 (Lagringsplats ).

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 Namn 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åt i pipelinen Install-Moduletill . Install-Module försöker bara installera modulen en gång.

Find-DscResource -Name xWebsite | Install-Module

Find-DscResource använder parametern Namn för att hitta resursen med namnet xWebsite. Objektet skickas nedåt i pipelinen till cmdleten Install-Module . Install-Module installerar xWebAdministration-modulen 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 version som krävs

DSC-resurser kan hittas med parametrarna Tag och RequiredVersion. Taggen 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 filterparametern för att ange resultatet efter domän. 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.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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, MaximumVersion eller RequiredVersion .

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

-Filter

Söker efter resurser baserat på PackageManagement-providerns söksyntax. Ange till exempel ord att söka efter i egenskaperna ModuleName och Description .

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

-MaximumVersion

Anger den maximala versionen av resursen som ska inkluderas i resultatet. Parametrarna MaximumVersion och RequiredVersion kan inte användas i samma kommando.

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

-MinimumVersion

Anger den lägsta versionen av resursen som ska inkluderas i resultatet. Parametrarna MinimumVersion och RequiredVersion kan inte användas i samma kommando.

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

-ModuleName

Anger en modul som innehåller DSC-resursen.

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

-Name

Anger namnet på en resurs. Standardvärdet är alla resurser. Använd kommatecken för att avgränsa en matris med resursnamn.

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

-Proxy

Anger en proxyserver för begäran i stället för en direktanslutning till Internetresursen.

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

-ProxyCredential

Anger ett användarkonto med behörighet att använda proxyservern som anges i proxyparametern.

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

-Repository

Anger en lagringsplats för att söka efter resurser. Använd kommatecken för att avgränsa en matris med lagringsplatsnamn.

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

-RequiredVersion

Anger modulens exakta versionsnummer som ska inkluderas i resultatet. Parametrarna RequiredVersion och MinimumVersion kan inte användas i samma kommando.

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

-Tag

Anger taggar som kategoriserar moduler i en lagringsplats. Använd kommatecken för att avgränsa en matris med taggar.

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

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 tillkännagivandet i PowerShell-bloggen.

Dela via

Find-DscResource

Syntax

Description

Exempel

Exempel 1: Hitta alla DSC-resurser

Exempel 2: Hitta en DSC-resurs efter namn

Exempel 3: Hitta en DSC-resurs och installera den

Exempel 4: Hitta alla DSC-resurser i en modul

Exempel 5: Hitta en DSC-resurs efter tagg och version som krävs

Exempel 6: Hitta en resurs med hjälp av ett filter

Parametrar

-AllowPrerelease

-AllVersions

-Filter

-MaximumVersion

-MinimumVersion

-ModuleName

-Name

-Proxy

-ProxyCredential

-Repository

-RequiredVersion

-Tag

Utdata

Kommentarer

Feedback

Ytterligare resurser

Dela via

Find-DscResource

Syntax

Description

Exempel

Exempel 1: Hitta alla DSC-resurser

Exempel 2: Hitta en DSC-resurs efter namn

Exempel 3: Hitta en DSC-resurs och installera den

Exempel 4: Hitta alla DSC-resurser i en modul

Exempel 5: Hitta en DSC-resurs efter tagg och version som krävs

Exempel 6: Hitta en resurs med hjälp av ett filter

Parametrar

-AllowPrerelease

-AllVersions

-Filter

-MaximumVersion

-MinimumVersion

-ModuleName

-Name

-Proxy

-ProxyCredential

-Repository

-RequiredVersion

-Tag

Utdata

Kommentarer

Relaterade länkar

Feedback

Ytterligare resurser