Find-DscResource

Referentie

Module:: PowerShellGet

Zoekt Desired State Configuration (DSC)-resources.

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

De Find-DscResource cmdlet doorzoekt geregistreerde opslagplaatsen om DSC-resources in modules te vinden. Standaard wordt Find-DscResource in alle geregistreerde opslagplaatsen gezocht.

Voor elke module die door Find-DscResourcewordt gevonden, wordt een PSGetDscResourceInfo-object geretourneerd. PSGetDscResourceInfo-objecten kunnen in de pijplijn naar de Install-Module cmdlet worden verzonden. Install-Module installeert de module.

Voorbeelden

Voorbeeld 1: Alle DSC-resources zoeken

Find-DscResource retourneert DSC-resources uit geregistreerde opslagplaatsen. Als u wilt zoeken in een specifieke opslagplaats, gebruikt u de parameter Opslagplaats .

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

Voorbeeld 2: Een DSC-resource zoeken op naam

Find-DscResource zoekt DSC-resources op naam. Gebruik komma's om een matrix met resourcenamen van elkaar te scheiden.

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 gebruikt de parameter Name om de opgegeven matrix met DSC-resources te vinden.

Voorbeeld 3: een DSC-resource zoeken en deze installeren

Find-DscResource zoekt een DSC-resource en verzendt het object naar beneden in de pijplijn die moet worden geïnstalleerd. Gebruik na de installatie Get-InstalledModule om de resultaten weer te geven.

Meerdere resources van dezelfde module kunnen door de pijplijn worden verzonden naar de Install-Module. Install-Module probeert de module slechts eenmaal te installeren.

Find-DscResource -Name xWebsite | Install-Module

Find-DscResource gebruikt de parameter Name om de resource met de naam xWebsite te vinden. Het object wordt door de pijplijn naar de Install-Module cmdlet verzonden. Install-Module installeert de module xWebAdministration voor de resource.

Voorbeeld 4: Alle DSC-resources in een module zoeken

Find-DscResource zoekt naar alle DSC-resources die zich in een opgegeven module bevinden. Standaard wordt de huidige versie weergegeven. Als u andere versies wilt weergeven, gebruikt u de parameters AllVersions of 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 gebruikt de parameter ModuleName om de xWebAdministration op te geven en de DSC-resources in de module te zoeken. De huidige versie van elke resource wordt weergegeven.

Voorbeeld 5: Een DSC-resource zoeken op tag en vereiste versie

DSC-resources kunnen worden gevonden met behulp van de parameters Tag en RequiredVersion. Tag geeft de huidige versie weer van elke resource die de opgegeven tag in de opslagplaats bevat. RequiredVersion heeft de parameter ModuleName nodig en de parameter Name is optioneel. De parameters Name en ModuleName beperken de uitvoer. Gebruik de parameter AllVersions om de beschikbare versies van een DSC-resource weer te geven.

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

Voorbeeld 6: Een resource zoeken met behulp van een filter

Find-DscResource zoekt alle resources en gebruikt de parameter Filter om de resultaten per domein op te geven. De filterparameter vindt de filterwaarde in de beschrijving of modulenaam van het object. Gebruik de cmdlet om de Select-Object eigenschappen van een object weer te geven.

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

Parameters

-AllowPrerelease

Bevat resources die zijn gemarkeerd als een prerelease in de resultaten.

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

-AllVersions

De parameter AllVersions geeft elk van de beschikbare versies van een DSC-resource weer. U kunt de parameter AllVersions niet gebruiken met de parameters MinimumVersion, MaximumVersion of RequiredVersion .

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

-Filter

Hiermee vindt u resources op basis van de zoeksyntaxis van de PackageManagement-provider . Geef bijvoorbeeld woorden op waarnaar moet worden gezocht in de eigenschappen ModuleName en Description .

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

-MaximumVersion

Hiermee geeft u de maximale versie van de resource op die in de resultaten moet worden opgenomen. De parameters MaximumVersion en RequiredVersion kunnen niet worden gebruikt in dezelfde opdracht.

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

-MinimumVersion

Hiermee geeft u de minimale versie van de resource op die in de resultaten moet worden opgenomen. De parameters MinimumVersion en RequiredVersion kunnen niet worden gebruikt in dezelfde opdracht.

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

-ModuleName

Hiermee geeft u een module die de DSC-resource bevat.

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

-Name

Hiermee geeft u de naam van een resource. De standaardwaarde is alle resources. Gebruik komma's om een matrix met resourcenamen van elkaar te scheiden.

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

-Proxy

Hiermee geeft u een proxyserver voor de aanvraag in plaats van een directe verbinding met de internetbron.

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

-ProxyCredential

Hiermee geeft u een gebruikersaccount op met machtigingen voor het gebruik van de proxyserver die is opgegeven in de proxyparameter .

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

-Repository

Hiermee geeft u een opslagplaats op om te zoeken naar resources. Gebruik komma's om een matrix met namen van opslagplaatsen te scheiden.

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

-RequiredVersion

Hiermee geeft u het exacte versienummer van de module op dat moet worden opgenomen in de resultaten. De parameters RequiredVersion en MinimumVersion kunnen niet worden gebruikt in dezelfde opdracht.

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

-Tag

Hiermee geeft u tags op die modules categoriseren in een opslagplaats. Gebruik komma's om een matrix met tags van elkaar te scheiden.

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

Uitvoerwaarden

PSGetDscResourceInfo

Find-DscResource retourneert een PSGetDscResourceInfo-object .

Notities

Belangrijk

Vanaf april 2020 biedt de PowerShell Gallery geen ondersteuning meer voor TLS-versies (Transport Layer Security) 1.0 en 1.1. Als u tls 1.2 of hoger niet gebruikt, krijgt u een foutmelding wanneer u toegang probeert te krijgen tot de PowerShell Gallery. Gebruik de volgende opdracht om ervoor te zorgen dat u TLS 1.2 gebruikt:

[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12

Zie de aankondiging in de PowerShell-blog voor meer informatie.

Delen via

Find-DscResource

Syntax

Description

Voorbeelden

Voorbeeld 1: Alle DSC-resources zoeken

Voorbeeld 2: Een DSC-resource zoeken op naam

Voorbeeld 3: een DSC-resource zoeken en deze installeren

Voorbeeld 4: Alle DSC-resources in een module zoeken

Voorbeeld 5: Een DSC-resource zoeken op tag en vereiste versie

Voorbeeld 6: Een resource zoeken met behulp van een filter

Parameters

-AllowPrerelease

-AllVersions

-Filter

-MaximumVersion

-MinimumVersion

-ModuleName

-Name

-Proxy

-ProxyCredential

-Repository

-RequiredVersion

-Tag

Uitvoerwaarden

Notities

Aanvullende resources

Delen via

Find-DscResource

Syntax

Description

Voorbeelden

Voorbeeld 1: Alle DSC-resources zoeken

Voorbeeld 2: Een DSC-resource zoeken op naam

Voorbeeld 3: een DSC-resource zoeken en deze installeren

Voorbeeld 4: Alle DSC-resources in een module zoeken

Voorbeeld 5: Een DSC-resource zoeken op tag en vereiste versie

Voorbeeld 6: Een resource zoeken met behulp van een filter

Parameters

-AllowPrerelease

-AllVersions

-Filter

-MaximumVersion

-MinimumVersion

-ModuleName

-Name

-Proxy

-ProxyCredential

-Repository

-RequiredVersion

-Tag

Uitvoerwaarden

Notities

Verwante koppelingen

Aanvullende resources