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

Publish-DscConfiguration

Модуль:
PSDesiredStateConfiguration Module v1.1

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

Синтаксис

ComputerNameSet (по умолчанию) 

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

CimSessionSet 

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

Описание

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

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

Примеры

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

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

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

Параметры

-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
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

ComputerNameSet
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-Force

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

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

Тип:SwitchParameter
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-Path

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

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

Тип: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.