Find-DscResource

Referenz

Modul:: PowerShellGet

Sucht nach Desired State Configuration (DSC)-Ressourcen.

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.

Für jedes von Find-DscResourcegefundene Modul wird ein PSGetDscResourceInfo-Objekt zurückgegeben. PSGetDscResourceInfo-Objekte können über die Pipeline an das Install-Module Cmdlet gesendet werden. Install-Module installiert das Modul.

Beispiele

Beispiel 1: Suchen aller DSC-Ressourcen

Find-DscResource gibt DSC-Ressourcen aus registrierten Repositorys zurück. Verwenden Sie den Parameter Repository , um ein bestimmtes Repository zu durchsuchen.

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

Beispiel 2: 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 suchen.

Beispiel 3: Suchen und Installieren einer DSC-Ressource

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

Mehrere Ressourcen aus demselben Modul können über die Pipeline an gesendet Install-Modulewerden. 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 xWebAdministration-Modul für die Ressource.

Beispiel 4: Suchen aller DSC-Ressourcen in einem Modul

Find-DscResource sucht nach allen DSC-Ressourcen, die in einem angegebenen Modul enthalten sind. Standardmäßig wird die aktuelle Version angezeigt. Verwenden Sie zum Anzeigen anderer Versionen die Parameter AllVersions oder RequiredVersions .

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 verwendet den Parameter ModuleName , um xWebAdministration anzugeben und die im Modul enthaltenen DSC-Ressourcen zu suchen. Die aktuelle Version jeder Ressource wird angezeigt.

Beispiel 5: Suchen einer DSC-Ressource nach Tag und erforderlicher Version

DSC-Ressourcen können mithilfe der Parameter Tag und RequiredVersion gefunden werden. Tag zeigt die aktuelle Version jeder Ressource an, die das angegebene Tag im Repository enthält. RequiredVersion benötigt den Parameter ModuleName , und der Name-Parameter ist optional. Die Parameter Name und ModuleName beschränken die Ausgabe. Verwenden Sie den AllVersions-Parameter , um die verfügbaren Versionen einer DSC-Ressource anzuzeigen.

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

Beispiel 6: Suchen einer Ressource mithilfe eines Filters

Find-DscResource findet alle Ressourcen und verwendet den Filter-Parameter , um die Ergebnisse nach Domäne anzugeben. Der Parameter Filter sucht den Filterwert in der Beschreibung oder dem Modulnamen des Objekts. Verwenden Sie das Select-Object Cmdlet, um die Eigenschaften eines Objekts anzuzeigen.

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

Parameter

-AllowPrerelease

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

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

-AllVersions

Der AllVersions-Parameter zeigt die verfügbaren Versionen einer DSC-Ressource an. Sie können den AllVersions-Parameter nicht mit den Parametern MinimumVersion, MaximumVersion oder RequiredVersion verwenden.

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

-Filter

Sucht Ressourcen basierend auf der Suchsyntax des PackageManagement-Anbieters . Geben Sie beispielsweise Wörter an, nach der gesucht werden soll, innerhalb der Eigenschaften ModuleName und Description .

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

-MaximumVersion

Gibt die maximale Version der Ressource an, die in den Ergebnissen enthalten sein soll. Die Parameter MaximumVersion und RequiredVersion können nicht im gleichen Befehl verwendet werden.

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

-MinimumVersion

Gibt die Mindestversion der Ressource an, die in die Ergebnisse eingeschlossen werden soll. Die Parameter MinimumVersion und RequiredVersion können nicht im gleichen Befehl verwendet werden.

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

-ModuleName

Gibt ein Modul an, das die DSC-Ressource enthält.

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.

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

-Proxy

Gibt einen Proxyserver für die Anforderung anstelle einer direkten Verbindung mit der Internetressource an.

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

-ProxyCredential

Gibt ein Benutzerkonto mit der Berechtigung an, den im Proxy-Parameter angegebenen Proxyserver zu verwenden.

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

-Repository

Gibt ein Repository an, das nach Ressourcen gesucht werden soll. 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

Gibt die genaue Versionsnummer des Moduls an, die in die Ergebnisse aufgenommen werden soll. Die Parameter RequiredVersion und MinimumVersion können nicht im gleichen Befehl verwendet werden.

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

-Tag

Gibt Tags an, die Module in einem Repository kategorisieren. Verwenden Sie Kommas, um ein Array von Tags zu trennen.

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

Wichtig

Ab April 2020 unterstützt der PowerShell-Katalog die TLS-Versionen (Transport Layer Security) 1.0 und 1.1 nicht mehr. Wenn Sie nicht TLS 1.2 oder höher verwenden, erhalten Sie beim Versuch des Zugriffs auf den PowerShell-Katalog eine Fehlermeldung. Mit dem folgenden Befehl können Sie sicherstellen, dass Sie TLS 1.2 verwenden:

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

Weitere Informationen finden Sie im PowerShell-Blog in der Ankündigung.

Find-DscResource

Syntax

Beschreibung

Beispiele

Beispiel 1: Suchen aller DSC-Ressourcen

Beispiel 2: Suchen einer DSC-Ressource anhand des Namens

Beispiel 3: Suchen und Installieren einer DSC-Ressource

Beispiel 4: Suchen aller DSC-Ressourcen in einem Modul

Beispiel 5: Suchen einer DSC-Ressource nach Tag und erforderlicher Version

Beispiel 6: Suchen einer Ressource mithilfe eines Filters

Parameter

-AllowPrerelease

-AllVersions

-Filter

-MaximumVersion

-MinimumVersion

-ModuleName

-Name

-Proxy

-ProxyCredential

-Repository

-RequiredVersion

-Tag

Ausgaben

Hinweise

Feedback

Zusätzliche Ressourcen

Find-DscResource

Syntax

Beschreibung

Beispiele

Beispiel 1: Suchen aller DSC-Ressourcen

Beispiel 2: Suchen einer DSC-Ressource anhand des Namens

Beispiel 3: Suchen und Installieren einer DSC-Ressource

Beispiel 4: Suchen aller DSC-Ressourcen in einem Modul

Beispiel 5: Suchen einer DSC-Ressource nach Tag und erforderlicher Version

Beispiel 6: Suchen einer Ressource mithilfe eines Filters

Parameter

-AllowPrerelease

-AllVersions

-Filter

-MaximumVersion

-MinimumVersion

-ModuleName

-Name

-Proxy

-ProxyCredential

-Repository

-RequiredVersion

-Tag

Ausgaben

Hinweise

Ähnliche Themen

Feedback

Zusätzliche Ressourcen