Delen via

Find-DscResource

  • Referentie
Module:
PowerShellGet

Hiermee vindt u 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 worden Find-DscResource alle geregistreerde opslagplaatsen doorzocht.

Dit is een proxy-cmdlet voor de Find-PSResource cmdlet in Microsoft.PowerShell.PSResourceGet. Zie Find-PSResource voor meer informatie.

Voorbeelden

Voorbeeld 1: 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 2: 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.

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.

Parameters

-AllowPrerelease

Bevat resources die zijn gemarkeerd als een voorlopige versie in de resultaten.

De proxy-cmdlet wijst deze parameter toe aan de prerelease-parameter van Find-PSResource.

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

-AllVersions

De proxy-cmdlet negeert deze parameter omdat deze niet wordt ondersteund door de DscResourceNameParameterSet van Find-PSResource.

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

-Filter

De proxy-cmdlet negeert deze parameter omdat deze niet wordt ondersteund door de DscResourceNameParameterSet van Find-PSResource.

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

-MaximumVersion

De proxy-cmdlet negeert deze parameter omdat deze niet wordt ondersteund door de DscResourceNameParameterSet van Find-PSResource.

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

-MinimumVersion

De proxy-cmdlet negeert deze parameter omdat deze niet wordt ondersteund door de DscResourceNameParameterSet van Find-PSResource.

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

-ModuleName

De proxy-cmdlet negeert deze parameter omdat deze niet wordt ondersteund door de DscResourceNameParameterSet van Find-PSResource.

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.

De proxy-cmdlet wijst deze parameter toe aan de parameter DscResourceName van Find-PSResource.

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

-Proxy

De proxy-cmdlet negeert deze parameter omdat deze niet wordt ondersteund door de DscResourceNameParameterSet van Find-PSResource.

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

-ProxyCredential

De proxy-cmdlet negeert deze parameter omdat deze niet wordt ondersteund door de DscResourceNameParameterSet van Find-PSResource.

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

De proxy-cmdlet negeert deze parameter omdat deze niet wordt ondersteund door de DscResourceNameParameterSet van Find-PSResource.

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

-Tag

De proxy-cmdlet negeert deze parameter omdat deze niet wordt ondersteund door de DscResourceNameParameterSet van Find-PSResource.

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

De PowerShell Gallery biedt geen ondersteuning meer voor TLS-versies (Transport Layer Security) 1.0 en 1.1. U moet TLS 1.2 of hoger gebruiken. Gebruik de volgende opdracht om ervoor te zorgen dat u TLS 1.2 gebruikt:

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