Поделиться через

Find-DscResource

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

Находит ресурсы требуемой конфигурации состояния (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

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

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

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-AllVersions

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

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Filter

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

Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-MaximumVersion

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

Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-MinimumVersion

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

Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-ModuleName

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

Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Name

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

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

Тип:String[]
Position:0
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Proxy

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

Тип:Uri
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-ProxyCredential

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

Тип:PSCredential
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-Repository

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

Тип:String[]
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-RequiredVersion

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

Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Tag

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

Тип:String[]
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки: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