Freigeben über

Find-DscResource

  • Referenz
Modul:
PowerShellGet

Sucht die DSC-Ressourcen (Desired State Configuration).

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

Beschreibung

Das Find-DscResource Cmdlet durchsucht registrierte Repositorys, um DSC-Ressourcen zu finden, die in Modulen enthalten sind. Find-DscResource Standardmäßig werden alle registrierten Repositorys durchsucht.

Dies ist ein Proxy-Cmdlet für das Find-PSResource Cmdlet in microsoft.PowerShell.PSResourceGet. Weitere Informationen finden Sie unter Find-PSResource.

Beispiele

Beispiel 1: Suchen einer DSC-Ressource anhand des Namens

Find-DscResource sucht DSC-Ressourcen anhand des Namens. Verwenden Sie Kommas, um ein Array von Ressourcennamen zu trennen.

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 verwendet den Parameter Name , um das angegebene Array von DSC-Ressourcen zu finden.

Beispiel 2: Suchen einer DSC-Ressource und Installieren

Find-DscResource sucht eine DSC-Ressource und sendet das Objekt an die zu installierende Pipeline. Verwenden Sie Get-InstalledModule nach der Installation, um die Ergebnisse anzuzeigen.

Mehrere Ressourcen aus demselben Modul können an die Install-ModulePipeline gesendet werden. Install-Module versucht, das Modul nur einmal zu installieren.

Find-DscResource -Name xWebsite | Install-Module

Find-DscResource verwendet den Parameter Name , um die Ressource mit dem Namen "xWebsite" zu finden. Das Objekt wird an das Cmdlet Install-Module weitergeleitet. Install-Module installiert das xWebAdministration-Modul für die Ressource.

Parameter

-AllowPrerelease

Enthält Ressourcen, die in den Ergebnissen als Vorabrelease gekennzeichnet sind.

Das Proxy-Cmdlet ordnet diesen Parameter dem Parameter Prerelease von Find-PSResource.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-AllVersions

Das Proxy-Cmdlet ignoriert diesen Parameter, da er vom DscResourceNameParameterSet nicht Find-PSResourceunterstützt wird.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Filter

Das Proxy-Cmdlet ignoriert diesen Parameter, da er vom DscResourceNameParameterSet nicht Find-PSResourceunterstützt wird.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-MaximumVersion

Das Proxy-Cmdlet ignoriert diesen Parameter, da er vom DscResourceNameParameterSet nicht Find-PSResourceunterstützt wird.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-MinimumVersion

Das Proxy-Cmdlet ignoriert diesen Parameter, da er vom DscResourceNameParameterSet nicht Find-PSResourceunterstützt wird.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ModuleName

Das Proxy-Cmdlet ignoriert diesen Parameter, da er vom DscResourceNameParameterSet nicht Find-PSResourceunterstützt wird.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Name

Gibt den Namen einer Ressource an. Der Standardwert ist alle Ressourcen. Verwenden Sie Kommas, um ein Array von Ressourcennamen zu trennen.

Das Proxy-Cmdlet ordnet diesen Parameter dem Parameter DscResourceName von Find-PSResource.

Typ:String[]
Position:0
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Proxy

Das Proxy-Cmdlet ignoriert diesen Parameter, da er vom DscResourceNameParameterSet nicht Find-PSResourceunterstützt wird.

Typ:Uri
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-ProxyCredential

Das Proxy-Cmdlet ignoriert diesen Parameter, da er vom DscResourceNameParameterSet nicht Find-PSResourceunterstützt wird.

Typ:PSCredential
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-Repository

Gibt ein Repository an, das nach Ressourcen gesucht werden soll. Verwenden Sie Kommas, um ein Array von Repositorynamen zu trennen.

Typ:String[]
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-RequiredVersion

Das Proxy-Cmdlet ignoriert diesen Parameter, da er vom DscResourceNameParameterSet nicht Find-PSResourceunterstützt wird.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Tag

Das Proxy-Cmdlet ignoriert diesen Parameter, da er vom DscResourceNameParameterSet nicht Find-PSResourceunterstützt wird.

Typ:String[]
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Ausgaben

PSGetDscResourceInfo

Find-DscResource gibt ein PSGetDscResourceInfo -Objekt zurück.

Hinweise

Der PowerShell-Katalog unterstützt die Tls-Versionen 1.0 und 1.1 nicht mehr. Sie müssen TLS 1.2 oder höher verwenden. Verwenden Sie den folgenden Befehl, um sicherzustellen, dass Sie TLS 1.2 verwenden:

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