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 . Сеанс по умолчанию — текущий сеанс на локальном компьютере.

Type:CimSession[]
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ComputerName

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

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

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

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

-Force

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

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

-Path

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

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