Find-DscResource

Referentie

Module:: PowerShellGet

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

Syntaxis

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 Find-DscResource zoekt in alle geregistreerde opslagplaatsen.

Voor elke module gevonden door Find-DscResourcewordt een PSGetDscResourceInfo object geretourneerd. PSGetDscResourceInfo-objecten kunnen 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 een specifieke opslagplaats wilt doorzoeken, 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 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 van DSC-resources te vinden.

Voorbeeld 3: Een DSC-resource zoeken en installeren

Find-DscResource een DSC-resource zoekt en het object naar beneden verzendt om de pijplijn te installeren. Na de installatie gebruikt u Get-InstalledModule om de resultaten weer te geven.

Meerdere resources uit dezelfde module kunnen naar de Install-Moduleworden verzonden. Install-Module probeert de module slechts één keer te installeren.

Find-DscResource -Name xWebsite | Install-Module

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

Voorbeeld 4: Alle DSC-resources in een module zoeken

Find-DscResource vindt u alle DSC-resources in een opgegeven module. Standaard wordt de huidige versie weergegeven. Als u andere versies wilt weergeven, gebruikt u de AllVersions of RequiredVersions parameters.

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- moet de parameter ModuleName en de parameter Name optioneel zijn. 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 vindt alle resources en gebruikt de parameter Filter om de resultaten op te geven op basis van Domein. De parameter Filter zoekt de filterwaarde in de beschrijving of modulenaam van het object. Gebruik de cmdlet Select-Object om de 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 voorlopige versie in de resultaten.

Type:	SwitchParameter
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-AllVersions

In de parameter AllVersions worden alle beschikbare versies van een DSC-resource weergegeven. U kunt de parameter AllVersions niet gebruiken met de parameters MinimumVersion, MaximumVersionof RequiredVersion parameters.

Type:	SwitchParameter
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	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
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-MaximumVersion

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

Type:	String
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-MinimumVersion

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

Type:	String
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-ModuleName

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

Type:	String
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-Name

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

Type:	String[]
Position:	0
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	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
Vereist:	False
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-ProxyCredential

Hiermee geeft u een gebruikersaccount met toestemming voor het gebruik van de proxyserver die is opgegeven in de proxy parameter.

Type:	PSCredential
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-Repository

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

Type:	String[]
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-RequiredVersion

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

Type:	String
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-Tag

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

Type:	String[]
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	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

Syntaxis

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

-AllowPrerelease

-AllVersions

-Filter

-MaximumVersion

-MinimumVersion

-ModuleName

-Name

-Proxy

-ProxyCredential

-Repository

-RequiredVersion

-Tag

Uitvoerwaarden

Notities

Aanvullende resources

Delen via

Find-DscResource

Syntaxis

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

-AllowPrerelease

-AllVersions

-Filter

-MaximumVersion

-MinimumVersion

-ModuleName

-Name

-Proxy

-ProxyCredential

-Repository

-RequiredVersion

-Tag

Uitvoerwaarden

Notities

Verwante koppelingen

Aanvullende resources