Find-DscResource

Модуль:: PowerShellGet Module

Находит ресурсы требуемой конфигурации состояния (DSC).

Синтаксис

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

Описание

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

Для каждого модуля, найденного Find-DscResource, возвращается объект PSGetDscResourceInfo. объекты PSGetDscResourceInfo можно отправить конвейер в командлет Install-Module. Install-Module устанавливает модуль.

Примеры

Пример 1. Поиск всех ресурсов DSC

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

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

Пример 2. Поиск ресурса 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.

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

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

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

Find-DscResource -Name xWebsite | Install-Module

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

Пример 4. Поиск всех ресурсов DSC в модуле

Find-DscResource находит все ресурсы DSC, содержащиеся в указанном модуле. По умолчанию отображается текущая версия. Чтобы отобразить другие версии, используйте параметры AllVersions или 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

использует параметр moduleName для указания xWebAdministration и поиска ресурсов DSC, содержащихся в модуле. Отображается текущая версия каждого ресурса.

Пример 5. Поиск ресурса DSC по тегу и требуемой версии

Ресурсы DSC можно найти с помощью параметров тега и RequiredVersion. Тег отображает текущую версию каждого ресурса, содержащего указанный тег в репозитории. RequiredVersion требуется параметр ModuleName, а параметр Name является необязательным. Параметры Name и moduleName ограничивают выходные данные. Используйте параметр AllVersions для отображения доступных версий ресурса 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

Пример 6. Поиск ресурса с помощью фильтра

находит все ресурсы и использует параметр фильтра для указания результатовдомена . Параметр filter находит значение фильтра в описании или имени модуля объекта. Используйте командлет Select-Object для просмотра свойств объекта.

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

Параметры

-AllowPrerelease

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

Свойства параметров

Тип:	SwitchParameter
Значение по умолчанию:	None
Поддержка подстановочных знаков:	False
Не показывайте:	False

Наборы параметров

(All)

Позиция:	Named
Обязательный:	False
Ценность воронки продаж:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

-AllVersions

Параметр AllVersions отображает каждую из доступных версий ресурса DSC. Параметр AllVersions нельзя использовать с параметрами MinimumVersion, MaximumVersionили RequiredVersion.

Свойства параметров

Тип:	SwitchParameter
Значение по умолчанию:	None
Поддержка подстановочных знаков:	False
Не показывайте:	False

Наборы параметров

(All)

Позиция:	Named
Обязательный:	False
Ценность воронки продаж:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

-Filter

Находит ресурсы на основе синтаксиса поиска PackageManagement поставщика. Например, укажите слова для поиска в свойствах moduleName и Description.

Свойства параметров

Тип:	String
Значение по умолчанию:	None
Поддержка подстановочных знаков:	False
Не показывайте:	False

Наборы параметров

(All)

Позиция:	Named
Обязательный:	False
Ценность воронки продаж:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

-MaximumVersion

Указывает максимальную версию ресурса, включаемую в результаты. Параметр MaximumVersion и параметры RequiredVersion нельзя использовать в той же команде.

Свойства параметров

Тип:	String
Значение по умолчанию:	None
Поддержка подстановочных знаков:	False
Не показывайте:	False

Наборы параметров

(All)

Позиция:	Named
Обязательный:	False
Ценность воронки продаж:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

-MinimumVersion

Указывает минимальную версию ресурса, включаемую в результаты. Параметр MinimumVersion и параметры RequiredVersion нельзя использовать в той же команде.

Свойства параметров

Тип:	String
Значение по умолчанию:	None
Поддержка подстановочных знаков:	False
Не показывайте:	False

Наборы параметров

(All)

Позиция:	Named
Обязательный:	False
Ценность воронки продаж:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

-ModuleName

Указывает модуль, содержащий ресурс DSC.

Свойства параметров

Тип:	String
Значение по умолчанию:	None
Поддержка подстановочных знаков:	False
Не показывайте:	False

Наборы параметров

(All)

Позиция:	Named
Обязательный:	False
Ценность воронки продаж:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

-Name

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

Свойства параметров

Тип:	String[]
Значение по умолчанию:	None
Поддержка подстановочных знаков:	False
Не показывайте:	False

Наборы параметров

(All)

Позиция:	0
Обязательный:	False
Ценность воронки продаж:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

-Proxy

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

Свойства параметров

Тип:	Uri
Значение по умолчанию:	None
Поддержка подстановочных знаков:	False
Не показывайте:	False

Наборы параметров

(All)

Позиция:	Named
Обязательный:	False
Ценность воронки продаж:	False
Значение из конвейера по имени свойства:	True
Значение из оставшихся аргументов:	False

-ProxyCredential

Указывает учетную запись пользователя с разрешением на использование прокси-сервера, указанного в параметре Proxy .

Свойства параметров

Тип:	PSCredential
Значение по умолчанию:	None
Поддержка подстановочных знаков:	False
Не показывайте:	False

Наборы параметров

(All)

Позиция:	Named
Обязательный:	False
Ценность воронки продаж:	False
Значение из конвейера по имени свойства:	True
Значение из оставшихся аргументов:	False

-Repository

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

Свойства параметров

Тип:	String[]
Значение по умолчанию:	None
Поддержка подстановочных знаков:	False
Не показывайте:	False

Наборы параметров

(All)

Позиция:	Named
Обязательный:	False
Ценность воронки продаж:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

-RequiredVersion

Указывает точный номер версии модуля для включения в результаты. Параметры RequiredVersion и параметры minimumVersion не могут использоваться в той же команде.

Свойства параметров

Тип:	String
Значение по умолчанию:	None
Поддержка подстановочных знаков:	False
Не показывайте:	False

Наборы параметров

(All)

Позиция:	Named
Обязательный:	False
Ценность воронки продаж:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

-Tag

Указывает теги, классифицющие модули в репозитории. Используйте запятые для разделения массива тегов.

Свойства параметров

Тип:	String[]
Значение по умолчанию:	None
Поддержка подстановочных знаков:	False
Не показывайте:	False

Наборы параметров

(All)

Позиция:	Named
Обязательный:	False
Ценность воронки продаж:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

CommonParameters

Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в разделе about_CommonParameters.

Выходы

PSGetDscResourceInfo

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

Примечания

Это важно

По состоянию на апрель 2020 г. коллекция PowerShell больше не поддерживает протокол TLS версии 1.0 и 1.1. Если вы не используете TLS 1.2 или более поздней версии, при попытке получить доступ к коллекции PowerShell появится сообщение об ошибке. Используйте следующую команду, чтобы убедиться, что используется TLS 1.2:

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

Дополнительные сведения см. в объявления в блоге PowerShell.

Обратная связь

Были ли сведения на этой странице полезными?

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

Find-DscResource

Синтаксис

All

Описание

Примеры

Пример 1. Поиск всех ресурсов DSC

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

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

Пример 4. Поиск всех ресурсов DSC в модуле

Пример 5. Поиск ресурса DSC по тегу и требуемой версии

Пример 6. Поиск ресурса с помощью фильтра

Параметры

-AllowPrerelease

Свойства параметров

Наборы параметров

-AllVersions

Свойства параметров

Наборы параметров

-Filter

Свойства параметров

Наборы параметров

-MaximumVersion

Свойства параметров

Наборы параметров

-MinimumVersion

Свойства параметров

Наборы параметров

-ModuleName

Свойства параметров

Наборы параметров

-Name

Свойства параметров

Наборы параметров

-Proxy

Свойства параметров

Наборы параметров

-ProxyCredential

Свойства параметров

Наборы параметров

-Repository

Свойства параметров

Наборы параметров

-RequiredVersion

Свойства параметров

Наборы параметров

-Tag

Свойства параметров

Наборы параметров

CommonParameters

Выходы

PSGetDscResourceInfo

Примечания

Ссылки по теме

Обратная связь