Командлет Start-DscConfiguration применяет конфигурацию к узлам. При использовании с параметром UseExisting применяется существующая конфигурация на целевом компьютере. Укажите, к каким компьютерам требуется применить конфигурацию, указав имена компьютеров или используя сеансы Common Information Model (CIM).
По умолчанию этот командлет создает задание и возвращает объект задания . Дополнительные сведения о фоновых заданиях введите Get-Help about_Jobs. Чтобы использовать этот командлет в интерактивном режиме, укажите параметр wait.
Укажите параметр подробные, чтобы узнать, что делает командлет при применении параметров конфигурации.
Эта команда применяет настройки конфигурации к C:\DSC\Configurations\ каждому компьютеру, у которого есть настройки в этой папке. Команда возвращает объекты задания для каждого целевого узла, развернутого в.
Пример 2. Применение параметров конфигурации и ожидание завершения настройки
Эта команда применяет конфигурацию из C:\DSC\Configurations\ локального компьютера. Команда возвращает объекты задания для каждого целевого узла, развернутого в данном случае, только на локальном компьютере. В этом примере задается параметр Verbose . Таким образом, команда отправляет сообщения на консоль по мере ее выполнения. Команда включает параметр Wait . Таким образом, вы не сможете использовать консоль до тех пор, пока команда не завершит все задачи настройки.
Пример 3. Применение параметров конфигурации с помощью сеанса CIM
В этом примере параметры конфигурации применяются к указанному компьютеру. В примере создается сеанс CIM для компьютера с именем Server01 для использования с командлетом. Кроме того, создайте массив сеансов CIM для применения командлета к нескольким указанным компьютерам.
Первая команда создает сеанс CIM с помощью командлета New-CimSession, а затем сохраняет объект CimSession в переменной $Session. Командная строка задает пароль. Для получения дополнительной информации введите Get-Help NewCimSession.
Вторая команда применяет параметры конфигурации из C:\DSC\Configurations компьютеров, определенных объектами CimSession , хранящимися $Session в переменной. В этом примере $Session переменная содержит сеанс CIM только для компьютера с именем Server01. Команда применяет конфигурацию. Команда создает объекты задания для каждого настроенного компьютера.
Параметры
-CimSession
Выполняет командлет в удаленном сеансе или на удаленном компьютере. Введите имя компьютера или объект сеанса, например выходные данные командлета Get-CimSession или Get-CimSession. По умолчанию используется текущий сеанс на локальном компьютере.
Задает массив имен компьютеров. Этот параметр ограничивает количество компьютеров, на которых в параметре Path есть конфигурационные документы, только теми, которые указаны в массиве.
Указывает имя пользователя и пароль в качестве объекта PSCredential для целевого компьютера.
Чтобы получить объект PSCredential, используйте командлет.Get-Credential
Для получения дополнительной информации введите Get-Help Get-Credential.
Останавливает операцию конфигурации, запущенную на целевом компьютере, и начинает новую операцию Start-Configuration. Если для свойства RefreshMod e локального диспетчера конфигураций задано значение Pull, указывая этот параметр на push-.
Указывает путь к файлу папки, содержащей файлы параметров конфигурации. Этот командлет публикует и применяет эти параметры конфигурации к компьютерам, у которых файлы параметров находятся по указанному пути. Каждый целевой узел должен иметь файл настроек следующего формата: <NetBIOS Name>.mof.
Указывает максимальное количество параллельных операций, которые можно установить для выполнения командлета. Если этот параметр опущен или введено значение 0, Windows PowerShell вычисляет оптимальное ограничение регулирования для командлета на основе количества командлетов CIM, работающих на компьютере. Ограничение регулирования применяется только к текущему командлету, а не к сеансу или к компьютеру.
Указывает, что этот командлет применяет существующую конфигурацию. Конфигурация может существовать на целевом компьютере путем ввода в действие с помощью Start-DscConfiguration командлета Publish-DscConfiguration или путем публикации.
Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в разделе about_CommonParameters.
Исходный код этого содержимого можно найти на GitHub, где вы также можете создавать и просматривать проблемы и запросы на вытягивание. Для получения дополнительной информации см. наше руководство для авторов.
