Find-DscResource
Sucht die DSC-Ressourcen (Desired State Configuration).
Syntax
All
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.
Für jedes Von diesem Modul gefundene Find-DscResourceModul wird ein PSGetDscResourceInfo-Objekt zurückgegeben.
PSGetDscResourceInfo-Objekte können 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 Repository-Parameter , 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 finden.
Beispiel 3: 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.
Beispiel 4: Suchen aller DSC-Ressourcen in einem Modul
Find-DscResource findet alle 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 die xWebAdministration anzugeben und die im Modul enthaltenen DSC-Ressourcen zu finden. 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 Parameter "AllVersions ", 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 Parameter "Filter ", um die Ergebnisse nach Domäne anzugeben. Der Filterparameter findet 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 in den Ergebnissen als Vorabrelease gekennzeichnet sind.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-AllVersions
Der Parameter AllVersions zeigt jede der verfügbaren Versionen einer DSC-Ressource an. Sie können den Parameter "AllVersions" nicht mit den Parametern "MinimumVersion", "MaximumVersion" oder "RequiredVersion " verwenden.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-Filter
Sucht Ressourcen basierend auf der Suchsyntax des PackageManagement-Anbieters . Geben Sie z. B. Wörter an, die innerhalb der ModuleName- und Description- Eigenschaften gesucht werden sollen.
Parametereigenschaften
| Typ: | String |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-MaximumVersion
Gibt die maximale Version der Ressource an, die in Ergebnisse eingeschlossen werden soll. Die MaximumVersion- und die parameter RequiredVersion können nicht im gleichen Befehl verwendet werden.
Parametereigenschaften
| Typ: | String |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-MinimumVersion
Gibt die Mindestversion der Ressource an, die in Ergebnisse eingeschlossen werden soll. Die MinimumVersion- und die parameter RequiredVersion können nicht im gleichen Befehl verwendet werden.
Parametereigenschaften
| Typ: | String |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-ModuleName
Gibt ein Modul an, das die DSC-Ressource enthält.
Parametereigenschaften
| Typ: | String |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-Name
Gibt den Namen einer Ressource an. Der Standardwert ist alle Ressourcen. Verwenden Sie Kommas, um ein Array von Ressourcennamen zu trennen.
Parametereigenschaften
| Typ: | String[] |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | 0 |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-Proxy
Gibt einen Proxyserver für die Anforderung anstelle einer direkten Verbindung mit der Internetressource an.
Parametereigenschaften
| Typ: | Uri |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | True |
| Wert aus verbleibenden Argumenten: | False |
-ProxyCredential
Gibt ein Benutzerkonto mit der Berechtigung an, den im Proxyparameter angegebenen Proxyserver zu verwenden.
Parametereigenschaften
| Typ: | PSCredential |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | True |
| Wert aus verbleibenden Argumenten: | False |
-Repository
Gibt ein Repository an, das nach Ressourcen gesucht werden soll. Verwenden Sie Kommas, um ein Array von Repositorynamen zu trennen.
Parametereigenschaften
| Typ: | String[] |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-RequiredVersion
Gibt die genaue Versionsnummer des Moduls an, die in die Ergebnisse eingeschlossen werden soll. Die Parameter "RequiredVersion" und " MinimumVersion " können nicht im selben Befehl verwendet werden.
Parametereigenschaften
| Typ: | String |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-Tag
Gibt Tags an, die Module in einem Repository kategorisieren. Verwenden Sie Kommas, um ein Array von Tags zu trennen.
Parametereigenschaften
| Typ: | String[] |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
CommonParameters
Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.
Ausgaben
PSGetDscResourceInfo
Find-DscResource gibt ein PSGetDscResourceInfo -Objekt zurück.
Hinweise
Von Bedeutung
Ab April 2020 unterstützt der PowerShell-Katalog die Tls-Versionen 1.0 und 1.1 nicht mehr. Wenn Sie TLS 1.2 oder höher nicht verwenden, wird beim Versuch, auf den PowerShell-Katalog zuzugreifen, eine Fehlermeldung angezeigt. Verwenden Sie den folgenden Befehl, um sicherzustellen, dass Sie TLS 1.2 verwenden:
[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
Weitere Informationen finden Sie in der Ankündigung im PowerShell-Blog.
