Поделиться через


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

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

Свойства параметра

Тип:

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.