Start-DscConfiguration

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

Применяет конфигурацию к узлам.

Синтаксис

Start-DscConfiguration
     [-Wait]
     [-Force]
     [[-Path] <String>]
     [[-ComputerName] <String[]>]
     [-Credential <PSCredential>]
     [-ThrottleLimit <Int32>]
     [-JobName <String>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-DscConfiguration
     [-Wait]
     [-Force]
     [[-Path] <String>]
     -CimSession <CimSession[]>
     [-ThrottleLimit <Int32>]
     [-JobName <String>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-DscConfiguration
     [-Wait]
     [-Force]
     [[-ComputerName] <String[]>]
     [-Credential <PSCredential>]
     [-ThrottleLimit <Int32>]
     [-UseExisting]
     [-JobName <String>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-DscConfiguration
     [-Wait]
     [-Force]
     -CimSession <CimSession[]>
     [-ThrottleLimit <Int32>]
     [-UseExisting]
     [-JobName <String>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Описание

Командлет Start-DscConfiguration применяет конфигурацию к узлам. При использовании с параметром UseExisting применяется существующая конфигурация на целевом компьютере. Укажите компьютеры, к которым требуется применить конфигурацию, указав имена компьютеров или с помощью сеансов CIM.

По умолчанию этот командлет создает задание и возвращает объект Job. Чтобы получить дополнительные сведения о фоновых заданиях, введите Get-Help about_Jobs. Чтобы использовать этот командлет в интерактивном режиме, укажите параметр Wait.

Задайте параметр Verbose, чтобы посмотреть сведения о действиях командлета при применении параметров конфигурации.

Примеры

Пример 1. Применение параметров конфигурации

Start-DscConfiguration -Path "C:\DSC\Configurations\"

Эта команда применяет параметры конфигурации из C:\DSC\Configurations\ к каждому компьютеру с параметрами в этой папке. Команда возвращает объекты Job для каждого целевого узла, в котором они развернуты.

Пример 2. Применение параметров конфигурации и ожидание завершения настройки

Start-DscConfiguration -Path "C:\DSC\Configurations\" -Wait -Verbose

Эта команда применяет конфигурацию из C:\DSC\Configurations\ к локальному компьютеру. Команда возвращает объекты Job для каждого целевого узла, в котором они развернуты (в данном случае просто локальный компьютер). В этом примере задается параметр Verbose . Поэтому команда отправляет сообщения в консоль по мере продолжения. Команда включает параметр Wait . Поэтому консоль нельзя использовать до тех пор, пока команда не завершит все задачи настройки.

Пример 3. Применение параметров конфигурации с помощью сеанса CIM

$Session = New-CimSession -ComputerName "Server01" -Credential ACCOUNTS\PattiFuller
Start-DscConfiguration -Path "C:\DSC\Configurations\" -CimSession $Session

В этом примере к указанному компьютеру применяются параметры конфигурации. Пример создает сеанс CIM для компьютера с именем Server01, чтобы использовать с командлетом. Кроме того, можно создать массив сеансов CIM для применения командлета к нескольким указанным компьютерам.

Первая команда создает сеанс CIM с помощью командлета New-CimSession , а затем сохраняет объект CimSession в переменной $Session . Команда запрашивает пароль. Для получения дополнительных сведений введите Get-Help NewCimSession.

Вторая команда применяет параметры конфигурации из C:\DSC\Configurations к компьютерам, определенным объектами CimSession , хранящимися в переменной $Session . В этом примере $Session переменная содержит сеанс CIM только для компьютера Server01. Команда применяет конфигурацию. Команда создает объекты Job для каждого настроенного компьютера.

Параметры

-CimSession

Запуск командлета в удаленном сеансе или на удаленном компьютере. Введите имя компьютера или объект сеанса, например выходные данные командлета New-CimSession или Get-CimSession . Сеанс по умолчанию — текущий сеанс на локальном компьютере.

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

-ComputerName

Указывает массив имен компьютеров. Этот параметр ограничивает компьютеры с документами конфигурации в параметре Path теми, которые указаны в массиве.

Type:String[]
Aliases:CN, ServerName
Position:1
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Confirm

Запрос подтверждения перед выполнением командлета.

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

-Credential

Указывает имя пользователя и пароль как объект PSCredential для целевого компьютера. Чтобы получить объект PSCredential , используйте Get-Credential командлет . Для получения дополнительных сведений введите Get-Help Get-Credential.

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

-Force

Останавливает операцию настройки, выполняемую в данный момент на целевом компьютере, и начинает новую операцию Start-Configuration. Если для свойства RefreshMode локального Configuration Manager задано значение Pull, при указании этого параметра оно будет изменено на Push.

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

-JobName

Задает понятное имя для задания. Если указать этот параметр, командлет выполняется как задание и возвращает объект Job.

По умолчанию Windows PowerShell присваивает имя JobN, где N — целое число.

Если параметр Wait указан, не указывайте этот параметр.

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

-Path

Указывает путь к файлу папки, которая содержит файлы параметров конфигурации. Этот командлет публикует и применяет эти параметры конфигурации к компьютерам с файлами параметров по указанному пути. Каждый целевой узел должен иметь файл параметров следующего формата: <NetBIOS Name>.mof.

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

-ThrottleLimit

Указание максимального количества одновременных операций, которые можно выполнять для запуска командлета. Если этот параметр опущен или введено значение 0 , то Windows PowerShell вычисляет оптимальное ограничение регулирования для командлета на основе количества командлетов CIM, запущенных на компьютере. Предел регулирования применим только к текущему командлету, а не к сеансу или компьютеру.

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

-UseExisting

Указывает, что этот командлет применяет существующую конфигурацию. Конфигурация может существовать на целевом компьютере путем внедрения с помощью Start-DscConfiguration или публикации с помощью командлета Publish-DscConfiguration.

Прежде чем указывать этот параметр для этого командлета, ознакомьтесь со сведениями в статье Новые возможности в Windows PowerShell 5.0.

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

-Wait

Указывает, что командлет блокирует консоль, пока не завершит все задачи настройки.

Если этот параметр указан, не указывайте параметр JobName.

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

-WhatIf

Показывает, что произойдет при запуске командлета. Командлет не выполняется.

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