Update-DscConfiguration

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

Проверяет опрашивающий сервер на наличие обновленной конфигурации и применяет ее.

Синтаксис

Update-DscConfiguration
      [-Wait]
      [-JobName <String>]
      [[-ComputerName] <String[]>]
      [-Credential <PSCredential>]
      [-ThrottleLimit <Int32>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Update-DscConfiguration
      [-Wait]
      [-JobName <String>]
      [-ThrottleLimit <Int32>]
      -CimSession <CimSession[]>
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Описание

Командлет Update-DscConfiguration подключается к опрашиваемому серверу, загружает конфигурацию, если она отличается от текущей конфигурации на узле, а затем применяет конфигурацию к компьютеру.

Этот командлет доступен только в составе накопительного пакета обновления за ноябрь 2014 г. для Windows RT 8.1, Windows 8.1 и Windows Server 2012 R2.

Примеры

Пример 1. Обновление конфигурации

Update-DscConfiguration -Wait -Verbose

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

Пример 2. Обновление конфигурации путем подключения через сеанс CIM

$Session = New-CimSession -ComputerName "Server01" -Credential ACCOUNTS\PattiFuller
Update-DscConfiguration -CimSession $Session -Wait

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

Вторая команда обновляет компьютер, указанный в CimSession , хранящейся в $Session. Команда задает параметр Wait . Консоль не принимает дополнительные команды до завершения текущей команды.

Параметры

-CimSession

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

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

-ComputerName

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

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

-JobName

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

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

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

Type:String
Position:Named
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

-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