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

Publish-DscConfiguration

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

Публикует конфигурацию DSC на наборе компьютеров.

Синтаксис

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

Описание

Командлет Publish-DscConfiguration публикует документ конфигурации Windows PowerShell Desired State Configuration (DSC) на множестве компьютеров. Этот командлет не применяет конфигурацию. Конфигурации применяются командлетом Start-DscConfiguration при использовании с параметром UseExisting или при запуске цикла согласованности подсистемы DSC. Подсистема DSC также называется локальной Configuration Manager (LCM).

Этот командлет особенно полезен при доставке фрагментов нескольких документов конфигурации. При доставке нескольких фрагментов документов конфигурации они перезаписывают старые фрагменты документов конфигурации.

Примеры

Пример 1. Публикация конфигурации на удаленном компьютере

Publish-DscConfiguration -Path '$home\WebServer' -ComputerName "ContosoWebServer" -Credential (get-credential Contoso\webadministrator)

Эта команда публикует конфигурацию на удаленном компьютере. Пользователь, запускающий командлет, должен быть администратором на удаленном компьютере.

Параметры

-CimSession

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

Тип:CimSession[]
Position:Named
Default value:None
Обязательно:True
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-ComputerName

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

Тип:String[]
Aliases:CN, ServerName
Position:1
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-Confirm

Запрос подтверждения перед выполнением командлета.

Тип:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Credential

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

Тип:PSCredential
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Force

Принудительное завершение командлета. Если для параметра Локальный режим обновления Configuration Manager задано значение PULL, использование этого параметра изменит его на PUSH и включает публикацию конфигурации DSC. Кроме того, если существует ожидающая конфигурация DSC, использование этого параметра перезаписывает ожидающую конфигурацию.

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Path

Указывает путь, содержащий конфигурации для публикации на целевых компьютерах.

Тип:String
Position:0
Default value:None
Обязательно:True
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-ThrottleLimit

Указание максимального количества одновременных операций, которые можно выполнять для запуска командлета. Если этот параметр опущен или введено значение 0 , то Windows PowerShell вычисляет оптимальное ограничение регулирования для командлета на основе количества командлетов CIM, запущенных на компьютере. Предел регулирования применим только к текущему командлету, а не к сеансу или компьютеру.

Тип:Int32
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-WhatIf

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

Тип:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False