Find-DscResource

  • Ссылка
Модуль:
PowerShellGet

Находит ресурсы Desired State Configuration (DSC).

Синтаксис

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

Описание

Командлет Find-DscResource выполняет поиск зарегистрированных репозиториев, чтобы найти ресурсы DSC, содержащиеся в модулях. По умолчанию Find-DscResource выполняет поиск во всех зарегистрированных репозиториях.

Это командлет прокси-сервера для командлета Find-PSResource в Microsoft.PowerShell.PSResourceGet. Дополнительные сведения см. в разделе Find-PSResource.

Примеры

Пример 1. Поиск ресурса DSC по имени

Find-DscResource находит ресурсы DSC по имени. Используйте запятые для разделения массива имен ресурсов.

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 использует параметр Name для поиска указанного массива ресурсов DSC.

Пример 2. Поиск и установка ресурса DSC

Find-DscResource находит ресурс DSC и отправляет объект вниз по конвейеру для установки. После установки используйте Get-InstalledModule для просмотра результатов.

Несколько ресурсов из одного модуля можно отправить по конвейеру в Install-Module. Install-Module пытается установить модуль только один раз.

Find-DscResource -Name xWebsite | Install-Module

Find-DscResource использует параметр Name для поиска ресурса с именем xWebsite. Объект отправляется по конвейеру в Install-Module командлет . Install-Module устанавливает модуль xWebAdministration для ресурса.

Параметры

-AllowPrerelease

Включает в результаты ресурсы, помеченные как предварительные выпуски.

Командлет прокси-сервера сопоставляет этот параметр с параметром Prerelease для Find-PSResource.

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

-AllVersions

Командлет прокси игнорирует этот параметр, так как он не поддерживается DscResourceNameParameterSet .Find-PSResource

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

-Filter

Командлет прокси игнорирует этот параметр, так как он не поддерживается DscResourceNameParameterSet .Find-PSResource

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

-MaximumVersion

Командлет прокси игнорирует этот параметр, так как он не поддерживается DscResourceNameParameterSet .Find-PSResource

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

-MinimumVersion

Командлет прокси игнорирует этот параметр, так как он не поддерживается DscResourceNameParameterSet .Find-PSResource

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

-ModuleName

Командлет прокси игнорирует этот параметр, так как он не поддерживается DscResourceNameParameterSet .Find-PSResource

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

-Name

Указывает имя ресурса. Значение по умолчанию — все ресурсы. Используйте запятые для разделения массива имен ресурсов.

Командлет прокси-сервера сопоставляет этот параметр с параметром DscResourceName объекта Find-PSResource.

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

-Proxy

Командлет прокси игнорирует этот параметр, так как он не поддерживается DscResourceNameParameterSet .Find-PSResource

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

-ProxyCredential

Командлет прокси игнорирует этот параметр, так как он не поддерживается DscResourceNameParameterSet .Find-PSResource

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

-Repository

Указывает репозиторий для поиска ресурсов. Используйте запятые для разделения массива имен репозитория.

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

-RequiredVersion

Командлет прокси игнорирует этот параметр, так как он не поддерживается DscResourceNameParameterSet .Find-PSResource

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

-Tag

Командлет прокси игнорирует этот параметр, так как он не поддерживается DscResourceNameParameterSet .Find-PSResource

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

Выходные данные

PSGetDscResourceInfo

Find-DscResource возвращает объект PSGetDscResourceInfo .

Примечания

Коллекция PowerShell больше не поддерживает протокол TLS версий 1.0 и 1.1. Необходимо использовать TLS 1.2 или более поздней версии. Чтобы проверить, используется ли TLS 1.2, выполните следующую команду:

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