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

Настройка опрашивающего клиента с помощью имен конфигураций в PowerShell 5.0 и более поздних версиях

Применимо к: Windows PowerShell 5.0

Это важно

Pull Server (Windows Feature DSC-Service) является поддерживаемым компонентом Windows Server, однако предложение новых функций или возможностей не планируется. Мы хотели бы, чтобы вы знали, что более новая версия DSC теперь общедоступна, управляется функцией Политики Azure под названием гостевая конфигурация. Служба гостевой конфигурации сочетает в себе функции расширения DSC, конфигурации состояния службы автоматизации Azure и наиболее часто запрашиваемые функции из отзывов клиентов. Гостевая конфигурация также включает поддержку гибридных компьютеров через серверы с поддержкой Arc.

Перед настройкой опрашивающего клиента необходимо настроить опрашивающий сервер. Хотя этот заказ не является обязательным, он помогает в устранении неполадок и помогает убедиться, что регистрация прошла успешно. Чтобы настроить опрашивающий сервер, вы можете воспользоваться следующими руководствами:

Каждый целевой узел можно настроить для загрузки конфигураций, ресурсов и даже составления отчетов о его состоянии. В следующих разделах показано, как настроить опрашивающий клиент с помощью общей папки SMB или вытягивающего сервера HTTP DSC. Когда LCM узла обновляется, он обращается к настроенному расположению для загрузки всех назначенных конфигураций. Если на узле отсутствуют какие-либо необходимые ресурсы, он автоматически загрузит их из настроенного расположения. Если узел настроен с сервером отчетов, он будет сообщать о состоянии операции.

Замечание

Этот раздел относится к PowerShell 5.0. Сведения о настройке опрашивающего клиента в PowerShell 4.0 см. в статье Настройка опрашивающего клиента с помощью идентификатора конфигурации в PowerShell 4.0.

Настройка LCM опрашивающего клиента

Выполнение любого из приведенных ниже примеров создает новую выходную папку с именем PullClientConfigName и помещает туда метаконфигурационный MOF-файл. В этом случае файл MOF метаконфигурации будет называться localhost.meta.mof.

Чтобы применить конфигурацию, вызовите командлет Set-DscLocalConfigurationManager , указав в поле Path расположение файла MOF метаконфигурации. Рассмотрим пример.

Set-DSCLocalConfigurationManager –ComputerName localhost –Path .\PullClientConfigName –Verbose.

Имя конфигурации

В приведенных ниже примерах свойство ConfigurationName LCM задается в соответствии с именем ранее скомпилированной конфигурации, созданной для этой цели. ConfigurationName — это то, что LCM использует для поиска подходящей конфигурации на опрашивающем сервере. Конфигурационный MOF-файл на опрашивающем сервере должен быть назван <ConfigurationName>.mof, в данном случае "ClientConfig.mof". Дополнительные сведения см. в разделе Публикация конфигураций на опрашивающем сервере (версии 4/5).

Настройка Pull Client для скачивания конфигураций

Каждый клиент должен быть настроен в режиме Pull и ему должен быть присвоен URL опрашивающего сервера, на котором хранится его конфигурация. Для этого необходимо настроить Local Configuration Manager (LCM) с необходимой информацией. Для настройки LCM необходимо создать специальный тип конфигурации, украшенный атрибутом DSCLocalConfigurationManager . Дополнительные сведения о настройке LCM см. в разделе Настройка локального диспетчера конфигураций.

Следующий сценарий настраивает LCM для извлечения конфигураций с сервера с именем "CONTOSO-PullSrv".

  • В скрипте блок ConfigurationRepositoryWeb определяет опрашивающий сервер. Свойство ServerURL указывает конечную точку для опрашивающего сервера.

  • Свойство RegistrationKey является общим ключом для всех клиентских узлов для опрашивающего сервера и этого опрашивающего сервера. Это же значение хранится в файле на опрашивающем сервере.

    Замечание

    Регистрационные ключи работают только с веб-пулл-серверами. Вы по-прежнему должны использовать ConfigurationID с опрашивающим сервером SMB . > Сведения о настройке опрашивающего сервера с помощью ConfigurationID см. в разделе Настройка опрашивающего клиента с помощью идентификатора конфигурации

  • Свойство ConfigurationNames — это массив, в котором указываются имена конфигураций, предназначенных для клиентского узла. > Заметка: Если в ConfigurationNames указано более одного значения, необходимо также указать блоки PartialConfiguration в конфигурации. >Сведения о частичных конфигурациях см. в статье Конфигурация требуемого состояния PowerShell Частичные конфигурации.

[DSCLocalConfigurationManager()]
configuration PullClientConfigNames
{
    Node localhost
    {
        Settings
        {
            RefreshMode = 'Pull'
            RefreshFrequencyMins = 30
            RebootNodeIfNeeded = $true
        }
        ConfigurationRepositoryWeb CONTOSO-PullSrv
        {
            ServerURL = 'https://CONTOSO-PullSrv:8080/PSDSCPullServer.svc'
            RegistrationKey = '140a952b-b9d6-406b-b416-e0f759c9c0e4'
            ConfigurationNames = @('ClientConfig')
        }
    }
}
PullClientConfigNames

Настройка Pull Client для загрузки ресурсов

Если в конфигурации LCM указан только блок ConfigurationRepositoryWeb или ConfigurationRepositoryShare (как в предыдущем примере), опрашивающий клиент будет извлекать ресурсы из того же места, где хранятся файлы ".mof". Вы также можете указать различные места, где клиенты могут скачивать ресурсы. Чтобы указать сервер ресурсов, используется либо ResourceRepositoryWeb (для веб-опрашивающего сервера), либо блок ResourceRepositoryShare (для опрашивающего сервера SMB).

В следующем примере показана метаконфигурация, которая настраивает клиент для загрузки конфигураций с опрашивающего сервера и ресурсов из общей папки SMB.

[DSCLocalConfigurationManager()]
configuration PullClientConfigNames
{
    Node localhost
    {
        Settings
        {
            RefreshMode = 'Pull'
            RefreshFrequencyMins = 30
            RebootNodeIfNeeded = $true
        }

        ConfigurationRepositoryWeb CONTOSO-PullSrv
        {
            ServerURL = 'https://CONTOSO-PullSrv:8080/PSDSCPullServer.svc'
            RegistrationKey = 'fbc6ef09-ad98-4aad-a062-92b0e0327562'
        }

        ResourceRepositoryShare SMBResources
        {
            SourcePath = '\\SMBPullServer\Resources'
        }
    }
}
PullClientConfigNames

Настройка Pull Client для создания отчетов о состоянии

Для конфигураций, ресурсов и отчетов можно использовать один опрашивающий сервер. По умолчанию отчетность для клиентов не настроена. Чтобы настроить клиент для создания отчетов о состоянии, необходимо создать блок ReportRepositoryWeb . В следующем примере показана метаконфигурация, которая настраивает клиента для извлечения конфигураций и ресурсов, а также отправки данных отчетов на один опрашивающий сервер.

Замечание

Сервер отчетов не может быть общим ресурсом SMB.

[DSCLocalConfigurationManager()]
configuration PullClientConfigNames
{
    Node localhost
    {
        Settings
        {
            RefreshMode = 'Pull'
            RefreshFrequencyMins = 30
            RebootNodeIfNeeded = $true
        }

        ConfigurationRepositoryWeb CONTOSO-PullSrv
        {
            ServerURL = 'https://CONTOSO-PullSrv:8080/PSDSCPullServer.svc'
            RegistrationKey = 'fbc6ef09-ad98-4aad-a062-92b0e0327562'
        }

        ReportServerWeb CONTOSO-PullSrv
        {
            ServerURL = 'https://CONTOSO-PullSrv:8080/PSDSCPullServer.svc'
            RegistrationKey = 'fbc6ef09-ad98-4aad-a062-92b0e0327562'
        }
    }
}
PullClientConfigNames

См. также