Find-DscResource

Odwołanie

Moduł:: PowerShellGet

Znajduje zasoby Desired State Configuration (DSC).

Składnia

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

Opis

Polecenie Find-DscResource cmdlet wyszukuje zarejestrowane repozytoria, aby znaleźć zasoby DSC zawarte w modułach. Domyślnie Find-DscResource wyszukuje wszystkie zarejestrowane repozytoria.

Dla każdego modułu znalezionego przez Find-DscResourceelement zwracany jest obiekt PSGetDscResourceInfo . Obiekty PSGetDscResourceInfo można wysłać w dół potoku Install-Module do polecenia cmdlet. Install-Module instaluje moduł.

Przykłady

Przykład 1. Znajdowanie wszystkich zasobów DSC

Find-DscResource zwraca zasoby DSC z zarejestrowanych repozytoriów. Aby wyszukać określone repozytorium, użyj parametru Repozytorium .

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

Przykład 2. Znajdowanie zasobu DSC według nazwy

Find-DscResource lokalizuje zasoby DSC według nazwy. Użyj przecinków, aby oddzielić tablicę nazw zasobów.

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 używa parametru Name , aby znaleźć określoną tablicę zasobów DSC.

Przykład 3. Znajdowanie zasobu DSC i instalowanie go

Find-DscResource lokalizuje zasób DSC i wysyła obiekt w dół potoku do zainstalowania. Po zakończeniu instalacji użyj polecenia Get-InstalledModule , aby wyświetlić wyniki.

Do potoku można wysłać wiele zasobów z tego samego modułu Install-Module. Install-Module próbuje zainstalować moduł tylko raz.

Find-DscResource -Name xWebsite | Install-Module

Find-DscResource używa parametru Name , aby znaleźć zasób o nazwie xWebsite. Obiekt jest wysyłany w dół potoku Install-Module do polecenia cmdlet. Install-Module instaluje moduł xWebAdministration dla zasobu.

Przykład 4. Znajdowanie wszystkich zasobów DSC w module

Find-DscResource znajduje wszystkie zasoby DSC zawarte w określonym module. Domyślnie jest wyświetlana bieżąca wersja. Aby wyświetlić inne wersje, użyj parametrów AllVersions lub 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 używa parametru ModuleName , aby określić xWebAdministration i znaleźć zasoby DSC zawarte w module. Zostanie wyświetlona bieżąca wersja każdego zasobu.

Przykład 5. Znajdowanie zasobu DSC według tagu i wymaganej wersji

Zasoby DSC można znaleźć przy użyciu parametrów Tag i RequiredVersion. Tag wyświetla bieżącą wersję każdego zasobu zawierającego określony tag w repozytorium. RequiredVersion wymaga parametru ModuleName , a parametr Name jest opcjonalny. Parametry Name i ModuleName ograniczają dane wyjściowe. Użyj parametru AllVersions , aby wyświetlić dostępne wersje zasobu DSC.

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

Przykład 6. Znajdowanie zasobu przy użyciu filtru

Find-DscResource znajduje wszystkie zasoby i używa parametru Filter w celu określenia wyników według domeny. Parametr Filter znajduje wartość filtru w opisie obiektu lub nazwie modułu. Select-Object Użyj polecenia cmdlet, aby wyświetlić właściwości obiektu.

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

Parametry

-AllowPrerelease

Zawiera zasoby oznaczone jako wersję wstępną w wynikach.

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

-AllVersions

Parametr AllVersions wyświetla każdą z dostępnych wersji zasobu DSC. Nie można użyć parametru AllVersions z parametrami MinimumVersion, MaximumVersion lub RequiredVersion .

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

-Filter

Znajduje zasoby na podstawie składni wyszukiwania dostawcy PackageManagement . Na przykład określ wyrazy, które mają być wyszukiwane we właściwościach ModuleName i Description .

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

-MaximumVersion

Określa maksymalną wersję zasobu do uwzględnienia w wynikach. Parametrów MaximumVersion i RequiredVersion nie można użyć w tym samym poleceniu.

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

-MinimumVersion

Określa minimalną wersję zasobu do uwzględnienia w wynikach. Parametrów MinimumVersion i RequiredVersion nie można użyć w tym samym poleceniu.

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

-ModuleName

Określa moduł zawierający zasób DSC.

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

-Name

Określa nazwę zasobu. Wartość domyślna to wszystkie zasoby. Użyj przecinków, aby oddzielić tablicę nazw zasobów.

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

-Proxy

Określa serwer proxy dla żądania, a nie bezpośrednie połączenie z zasobem internetowym.

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

-ProxyCredential

Określa konto użytkownika z uprawnieniami do używania serwera proxy określonego w parametrze serwera proxy .

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

-Repository

Określa repozytorium do wyszukiwania zasobów. Użyj przecinków, aby oddzielić tablicę nazw repozytoriów.

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

-RequiredVersion

Określa dokładny numer wersji modułu do uwzględnienia w wynikach. Parametrów RequiredVersion i MinimumVersion nie można użyć w tym samym poleceniu.

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

-Tag

Określa tagi, które kategoryzują moduły w repozytorium. Użyj przecinków, aby oddzielić tablicę tagów.

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

Dane wyjściowe

PSGetDscResourceInfo

Find-DscResource zwraca obiekt PSGetDscResourceInfo .

Uwagi

Ważne

Od kwietnia 2020 r. Galeria programu PowerShell nie obsługuje już protokołu Transport Layer Security (TLS) w wersji 1.0 i 1.1. Jeśli nie używasz protokołu TLS 1.2 lub nowszego, podczas próby uzyskania dostępu do Galeria programu PowerShell zostanie wyświetlony błąd. Użyj następującego polecenia, aby upewnić się, że używasz protokołu TLS 1.2:

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

Aby uzyskać więcej informacji, zobacz ogłoszenie w blogu programu PowerShell.

Udostępnij za pośrednictwem

Find-DscResource

Składnia

Opis

Przykłady

Przykład 1. Znajdowanie wszystkich zasobów DSC

Przykład 2. Znajdowanie zasobu DSC według nazwy

Przykład 3. Znajdowanie zasobu DSC i instalowanie go

Przykład 4. Znajdowanie wszystkich zasobów DSC w module

Przykład 5. Znajdowanie zasobu DSC według tagu i wymaganej wersji

Przykład 6. Znajdowanie zasobu przy użyciu filtru

Parametry

-AllowPrerelease

-AllVersions

-Filter

-MaximumVersion

-MinimumVersion

-ModuleName

-Name

-Proxy

-ProxyCredential

-Repository

-RequiredVersion

-Tag

Dane wyjściowe

Uwagi

Dodatkowe zasoby

Udostępnij za pośrednictwem

Find-DscResource

Składnia

Opis

Przykłady

Przykład 1. Znajdowanie wszystkich zasobów DSC

Przykład 2. Znajdowanie zasobu DSC według nazwy

Przykład 3. Znajdowanie zasobu DSC i instalowanie go

Przykład 4. Znajdowanie wszystkich zasobów DSC w module

Przykład 5. Znajdowanie zasobu DSC według tagu i wymaganej wersji

Przykład 6. Znajdowanie zasobu przy użyciu filtru

Parametry

-AllowPrerelease

-AllVersions

-Filter

-MaximumVersion

-MinimumVersion

-ModuleName

-Name

-Proxy

-ProxyCredential

-Repository

-RequiredVersion

-Tag

Dane wyjściowe

Uwagi

Linki powiązane

Dodatkowe zasoby