Set-DscLocalConfigurationManager
Применяет параметры Local Configuration Manager (LCM) к узлам.
Синтаксис
ComputerNameSet (по умолчанию)
Set-DscLocalConfigurationManager
[-Path] <String>
[[-ComputerName] <String[]>]
[-Force]
[-Credential <PSCredential>]
[-ThrottleLimit <Int32>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
CimSessionSet
Set-DscLocalConfigurationManager
[-Path] <String>
-CimSession <CimSession[]>
[-Force]
[-ThrottleLimit <Int32>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Описание
Командлет Set-DscLocalConfigurationManager применяет к узлам параметры LCM, или метаконфигурацию. Укажите компьютеры, указав имена компьютеров или используя сеансы Common Information Model (CIM). Если целевой компьютер не указан, командлет применяет параметры к локальному компьютеру.
Примеры
Пример 1. Применение параметров LCM
Set-DscLocalConfigurationManager -Path "C:\DSC\Configurations\"
Эта команда применяет настройки LCM от C:\DSC\Configurations\ целевых узлов. После получения параметров LCM обрабатывает их.
Предупреждение
Если в указанной папке хранится несколько мета-mof для одного и того же компьютера, будет применен только первый мета-mof.
Пример 2. Применение параметров LCM с помощью сеанса CIM
$Session = New-CimSession -ComputerName "Server01" -Credential ACCOUNTS\PattiFuller
Set-DscLocalConfigurationManager -Path "C:\DSC\Configurations\" -CimSession $Session
В этом примере параметры LCM применяются к компьютеру и применяются к этим параметрам. В примере создается сеанс CIM для компьютера с именем Server01 для использования с командлетом. Кроме того, создайте массив сеансов CIM для применения командлета к нескольким указанным компьютерам.
Первая команда создает сеанс CIM с помощью командлета New-CimSession, а затем сохраняет объект CimSession в переменной $Session. Командная строка задает пароль. Для получения дополнительной информации введите Get-Help New-CimSession.
Вторая команда применяет настройки LCM для целевого узла к C:\DSC\Configurations\ компьютеру, идентифицированному объектами CimSession , хранящимися $Session в переменной. В этом примере $Session переменная содержит сеанс CIM только для компьютера с именем Server01. Команда применяет параметры. После получения параметров LCM обрабатывает их.
Параметры
-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 |
-Force
Принудительно выполняется команда без запроса подтверждения пользователя.
Свойства параметра
| Тип: | SwitchParameter |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Path
Указывает путь к файлу папки, содержащей файлы параметров конфигурации. Командлет публикует и применяет эти параметры LCM к компьютерам с файлами параметров в указанном пути. Каждый целевой узел должен иметь файл настроек следующего формата: NetBIOS Name.meta.mof.
Свойства параметра
| Тип: | String |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | 0 |
| Обязательно: | True |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-ThrottleLimit
Указывает максимальное количество параллельных операций, которые можно установить для выполнения командлета. Если этот параметр опущен или введено значение 0, Windows PowerShell вычисляет оптимальное ограничение регулирования для командлета на основе количества командлетов CIM, работающих на компьютере. Ограничение регулирования применяется только к текущему командлету, а не к сеансу или к компьютеру.
Свойства параметра
| Тип: | Int32 |
| 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.