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-DscResource, возвращается объект PSGetDscResourceInfo . Объекты PSGetDscResourceInfo можно отправить по конвейеру в Install-Module командлет . Install-Module устанавливает модуль .

Примеры

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

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

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

Find-DscResource использует параметр Name для поиска ресурса с именем xWebsite. Объект отправляется по конвейеру в Install-Module командлет . 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

Find-DscResource использует параметр ModuleName , чтобы указать xWebAdministration и найти ресурсы DSC, содержащиеся в модуле. Отображается текущая версия каждого ресурса.

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

Ресурсы DSC можно найти с помощью параметров Tag и 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. Поиск ресурса с помощью фильтра

Find-DscResource находит все ресурсы и использует параметр Filter для указания результатов по домену. Параметр 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

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

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

-AllVersions

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

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

-Filter

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

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

-MaximumVersion

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

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

-MinimumVersion

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

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

-ModuleName

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

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

-Name

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

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

-Proxy

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

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

-ProxyCredential

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

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

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

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

-Tag

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

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

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

PSGetDscResourceInfo

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

Примечания

Важно!

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

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

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

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

Find-DscResource

Синтаксис

Описание

Примеры

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

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

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

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

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

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

Параметры

-AllowPrerelease

-AllVersions

-Filter

-MaximumVersion

-MinimumVersion

-ModuleName

-Name

-Proxy

-ProxyCredential

-Repository

-RequiredVersion

-Tag

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

Примечания

Дополнительные ресурсы

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

Find-DscResource

Синтаксис

Описание

Примеры

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

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

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

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

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

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

Параметры

-AllowPrerelease

-AllVersions

-Filter

-MaximumVersion

-MinimumVersion

-ModuleName

-Name

-Proxy

-ProxyCredential

-Repository

-RequiredVersion

-Tag

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

Примечания

Связанные ссылки

Дополнительные ресурсы