Find-DscResource

  • Referenz
Modul:
PowerShellGet

Sucht nach Desired State Configuration -Ressourcen (DSC).

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. Standardmäßig Find-DscResource werden alle registrierten Repositorys durchsucht.

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

Beispiele

Beispiel 1: Suchen einer DSC-Ressource nach Name

Find-DscResource sucht DSC-Ressourcen nach Name. 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 suchen.

Beispiel 2: Suchen und Installieren einer DSC-Ressource

Find-DscResource sucht eine DSC-Ressource und sendet das Objekt über die Pipeline, die installiert werden soll. 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 suchen. Das Objekt wird in der Pipeline an das Install-Module Cmdlet gesendet. Install-Module installiert das Modul xWebAdministration für die Ressource.

Parameter

-AllowPrerelease

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

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

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

-AllVersions

Das Proxy-Cmdlet ignoriert diesen Parameter, da er vom DscResourceNameParameterSet von Find-PSResourcenicht unterstützt wird.

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

-Filter

Das Proxy-Cmdlet ignoriert diesen Parameter, da er vom DscResourceNameParameterSet von Find-PSResourcenicht unterstützt wird.

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

-MaximumVersion

Das Proxy-Cmdlet ignoriert diesen Parameter, da er vom DscResourceNameParameterSet von Find-PSResourcenicht unterstützt wird.

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

-MinimumVersion

Das Proxy-Cmdlet ignoriert diesen Parameter, da er vom DscResourceNameParameterSet von Find-PSResourcenicht unterstützt wird.

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

-ModuleName

Das Proxy-Cmdlet ignoriert diesen Parameter, da er vom DscResourceNameParameterSet von Find-PSResourcenicht unterstützt wird.

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

-Name

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

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

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

-Proxy

Das Proxy-Cmdlet ignoriert diesen Parameter, da er vom DscResourceNameParameterSet von Find-PSResourcenicht unterstützt wird.

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

-ProxyCredential

Das Proxy-Cmdlet ignoriert diesen Parameter, da er vom DscResourceNameParameterSet von Find-PSResourcenicht unterstützt wird.

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

-Repository

Gibt ein Repository an, um nach Ressourcen zu suchen. Verwenden Sie Kommas, um ein Array von Repositorynamen zu trennen.

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

-RequiredVersion

Das Proxy-Cmdlet ignoriert diesen Parameter, da er vom DscResourceNameParameterSet von Find-PSResourcenicht unterstützt wird.

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

-Tag

Das Proxy-Cmdlet ignoriert diesen Parameter, da er vom DscResourceNameParameterSet von Find-PSResourcenicht unterstützt wird.

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

Ausgaben

PSGetDscResourceInfo

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

Hinweise

Die PowerShell-Katalog die TLS-Versionen 1.0 und 1.1 (Transport Layer Security) nicht mehr unterstützt. Sie müssen TLS 1.2 oder höher verwenden. Mit dem folgenden Befehl können Sie sicherstellen, dass Sie TLS 1.2 verwenden:

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