Set-DscLocalConfigurationManager

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

Применяет параметры локального Configuration Manager (LCM) к узлам.

Синтаксис

Set-DscLocalConfigurationManager
   [-Path] <String>
   [-Force]
   [[-ComputerName] <String[]>]
   [-Credential <PSCredential>]
   [-ThrottleLimit <Int32>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-DscLocalConfigurationManager
   [-Path] <String>
   [-Force]
   [-ThrottleLimit <Int32>]
   -CimSession <CimSession[]>
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Описание

Командлет Set-DscLocalConfigurationManager применяет параметры LCM (метаконфигурация) к узлам. Укажите компьютеры, выбрав имена компьютеров или используя сеансы модели CIM. Если целевой компьютер не указан, командлет применяет параметры к локальному компьютеру.

Примеры

Пример 1. Применение параметров LCM

Set-DscLocalConfigurationManager -Path "C:\DSC\Configurations\"

Эта команда применяет параметры LCM из C:\DSC\Configurations\ к целевым узлам. После получения параметров LCM обрабатывает их.

Предупреждение

Если для одного компьютера, хранящегося в указанной папке, имеется несколько метаданных, будет применен только первый мета 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

Запуск командлета в удаленном сеансе или на удаленном компьютере. Введите имя компьютера или объект сеанса, например выходные данные командлета 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

Принудительное выполнение команды без запроса на подтверждение пользователем.

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

-Path

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

Type:String
Position:0
Default value:None
Required:True
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

-WhatIf

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

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