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.

Det här är en proxy-cmdlet för Find-PSResource cmdleten i Microsoft.PowerShell.PSResourceGet. Mer information finns i Find-PSResource.

Exempel

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

Parametrar

-AllowPrerelease

Innehåller resurser som markerats som en förhandsversion i resultatet.

Proxy-cmdleten mappar den här parametern till parametern Prerelease för Find-PSResource.

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

-AllVersions

Proxy-cmdleten ignorerar den här parametern eftersom den inte stöds av DscResourceNameParameterSet för Find-PSResource.

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

-Filter

Proxy-cmdleten ignorerar den här parametern eftersom den inte stöds av DscResourceNameParameterSet för Find-PSResource.

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

-MaximumVersion

Proxy-cmdleten ignorerar den här parametern eftersom den inte stöds av DscResourceNameParameterSet för Find-PSResource.

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

-MinimumVersion

Proxy-cmdleten ignorerar den här parametern eftersom den inte stöds av DscResourceNameParameterSet för Find-PSResource.

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

-ModuleName

Proxy-cmdleten ignorerar den här parametern eftersom den inte stöds av DscResourceNameParameterSet för Find-PSResource.

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.

Proxy-cmdleten mappar den här parametern till parametern DscResourceName för Find-PSResource.

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

-Proxy

Proxy-cmdleten ignorerar den här parametern eftersom den inte stöds av DscResourceNameParameterSet för Find-PSResource.

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

-ProxyCredential

Proxy-cmdleten ignorerar den här parametern eftersom den inte stöds av DscResourceNameParameterSet för Find-PSResource.

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

Proxy-cmdleten ignorerar den här parametern eftersom den inte stöds av DscResourceNameParameterSet för Find-PSResource.

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

-Tag

Proxy-cmdleten ignorerar den här parametern eftersom den inte stöds av DscResourceNameParameterSet för Find-PSResource.

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

PowerShell-galleriet har inte längre stöd för TLS-versionerna 1.0 och 1.1. Du måste använda TLS 1.2 eller senare. Använd följande kommando för att se till att du använder TLS 1.2:

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