Update-DscConfiguration
Проверяет опрашивающий сервер на наличие обновленной конфигурации и применяет ее.
Синтаксис
ComputerNameSet (по умолчанию)
Update-DscConfiguration
[[-ComputerName] <String[]>]
[-Wait]
[-JobName <String>]
[-Credential <PSCredential>]
[-ThrottleLimit <Int32>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
CimSessionSet
Update-DscConfiguration
-CimSession <CimSession[]>
[-Wait]
[-JobName <String>]
[-ThrottleLimit <Int32>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Описание
Командлет Update-DscConfiguration подключается к опрашивающему серверу, загружает конфигурацию, если она отличается от текущей на узле, а затем применяет конфигурацию к компьютеру.
Этот командлет доступен только в рамках накопительного пакета обновления ноября 2014 г. для Windows RT 8.1, Windows 8.1 и Windows Server 2012 R2.
Примеры
Пример 1. Обновление конфигурации
Update-DscConfiguration -Wait -Verbose
После выполнения этой команды сервер подключится к зарегистрированной службе pull, загрузит последнюю назначенную конфигурацию, а затем применит ее. Параметры 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
Выполняет командлет в удаленном сеансе или на удаленном компьютере. Введите имя компьютера или объект сеанса, например выходные данные
Свойства параметра
| Тип: | |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
CimSessionSet
| Position: | Named |
| Обязательно: | True |
| Значение из конвейера: | True |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-ComputerName
Задает массив имен компьютеров. Командлет применяет параметры конфигурации к компьютерам, заданным этим параметром.
Свойства параметра
| Тип: | String[] |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
| Aliases: | Китай, Имя сервера |
Наборы параметров
ComputerNameSet
| Position: | 1 |
| Обязательно: | False |
| Значение из конвейера: | True |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Confirm
Запрашивает подтверждение перед запуском cmdlet.
Свойства параметра
| Тип: | SwitchParameter |
| Default value: | False |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
| Aliases: | cf |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Credential
Указывает имя пользователя и пароль в качестве объекта PSCredential для целевого компьютера. Чтобы получить объект PSCredential, используйте командлет.Get-Credential Для получения дополнительной информации введите Get-Help Get-Credential.
Свойства параметра
| Тип: | PSCredential |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
ComputerNameSet
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-JobName
Указывает понятное имя задания. Если указать этот параметр, командлет выполняется в качестве задания и возвращает объект Job.
По умолчанию Windows PowerShell назначает имя JobN, где N является целым числом.
Если указать параметр Wait, не указывайте этот параметр.
Свойства параметра
| Тип: | String |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-ThrottleLimit
Указывает максимальное количество параллельных операций, которые можно установить для выполнения командлета. Если этот параметр опущен или введено значение 0, Windows PowerShell вычисляет оптимальное ограничение регулирования для командлета на основе количества командлетов CIM, работающих на компьютере. Ограничение регулирования применяется только к текущему командлету, а не к сеансу или к компьютеру.
Свойства параметра
| Тип: | Int32 |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Wait
Указывает, что командлет блокирует консоль до завершения всех задач конфигурации.
Если этот параметр указан, не указывайте параметр JobName.
Свойства параметра
| Тип: | SwitchParameter |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-WhatIf
Показывает, что произойдет, если командлет будет запущен. Командлет не запускается.
Свойства параметра
| Тип: | SwitchParameter |
| Default value: | False |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
| Aliases: | wi |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
CommonParameters
Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в разделе about_CommonParameters.
