Find-DscResource

Referentie

Module:: PowerShellGet

Hiermee vindt u Desired State Configuration (DSC)-resources.

Syntax

PowerShell

Find-DscResource
    [[-Name] <String[]>]
    [-ModuleName <String>]
    [-MinimumVersion <Version>]
    [-MaximumVersion <Version>]
    [-RequiredVersion <Version>]
    [-AllVersions]
    [-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 worden Find-DscResource alle geregistreerde opslagplaatsen doorzocht.

Voor elke module die wordt gevonden door Find-DscResource, 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 .

PowerShell

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.

PowerShell

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 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 uit dezelfde module kunnen door de pijplijn worden verzonden naar de Install-Module. Install-Module probeert de module slechts eenmaal te installeren.

PowerShell

Find-DscResource -Name xWebsite | Install-Module

Find-DscResource gebruikt de parameter Name om de resource met de naam xWebsite te vinden. Het object wordt via 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 zijn opgenomen in een opgegeven module. Standaard wordt de huidige versie weergegeven. Als u andere versies wilt weergeven, gebruikt u de parameters AllVersions of RequiredVersions .

PowerShell

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 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.

PowerShell

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 vindt 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.

PowerShell

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

-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:	Version
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:	Version
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 parameter Proxy .

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

-Repository

Hiermee geeft u een opslagplaats om te zoeken naar resources. Gebruik komma's om een matrix met opslagplaatsnamen van elkaar 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:	Version
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Tag

Hiermee geeft u tags op die modules in een opslagplaats categoriseren. 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

Invoerwaarden

Uri

PSCredential

Uitvoerwaarden

PSCustomObject[]

Find-DscResource retourneert een PSCustomObject-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 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

-AllVersions

-Filter

-MaximumVersion

-MinimumVersion

-ModuleName

-Name

-Proxy

-ProxyCredential

-Repository

-RequiredVersion

-Tag

Invoerwaarden

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 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

-AllVersions

-Filter

-MaximumVersion

-MinimumVersion

-ModuleName

-Name

-Proxy

-ProxyCredential

-Repository

-RequiredVersion

-Tag

Invoerwaarden

Uitvoerwaarden

Notities

Verwante koppelingen

Aanvullende resources