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.

Jest to polecenie cmdlet serwera proxy dla Find-PSResource polecenia cmdlet w elemecie Microsoft.PowerShell.PSResourceGet. Aby uzyskać więcej informacji, zobacz Find-PSResource.

Przykłady

Przykład 1. 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 2. 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 do elementu 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.

Parametry

-AllowPrerelease

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

Polecenie cmdlet serwera proxy mapuje ten parametr na parametr wersji wstępnej polecenia Find-PSResource.

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

-AllVersions

Polecenie cmdlet serwera proxy ignoruje ten parametr, ponieważ nie jest obsługiwany przez element DscResourceNameParameterSet elementu Find-PSResource.

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

-Filter

Polecenie cmdlet serwera proxy ignoruje ten parametr, ponieważ nie jest obsługiwany przez element DscResourceNameParameterSet elementu Find-PSResource.

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

-MaximumVersion

Polecenie cmdlet serwera proxy ignoruje ten parametr, ponieważ nie jest obsługiwany przez element DscResourceNameParameterSet elementu Find-PSResource.

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

-MinimumVersion

Polecenie cmdlet serwera proxy ignoruje ten parametr, ponieważ nie jest obsługiwany przez element DscResourceNameParameterSet elementu Find-PSResource.

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

-ModuleName

Polecenie cmdlet serwera proxy ignoruje ten parametr, ponieważ nie jest obsługiwany przez element DscResourceNameParameterSet elementu Find-PSResource.

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.

Polecenie cmdlet serwera proxy mapuje ten parametr na parametr DscResourceName polecenia Find-PSResource.

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

-Proxy

Polecenie cmdlet serwera proxy ignoruje ten parametr, ponieważ nie jest obsługiwany przez element DscResourceNameParameterSet elementu Find-PSResource.

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

-ProxyCredential

Polecenie cmdlet serwera proxy ignoruje ten parametr, ponieważ nie jest obsługiwany przez element DscResourceNameParameterSet elementu Find-PSResource.

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

Polecenie cmdlet serwera proxy ignoruje ten parametr, ponieważ nie jest obsługiwany przez element DscResourceNameParameterSet elementu Find-PSResource.

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

-Tag

Polecenie cmdlet serwera proxy ignoruje ten parametr, ponieważ nie jest obsługiwany przez element DscResourceNameParameterSet elementu Find-PSResource.

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

Galeria programu PowerShell nie obsługuje już protokołu Transport Layer Security (TLS) w wersji 1.0 i 1.1. Należy użyć protokołu TLS 1.2 lub nowszego. Użyj następującego polecenia, aby upewnić się, że używasz protokołu TLS 1.2:

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