Set-CMPackageDeployment

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

Изменяет значения, определяющие способ развертывания пакета программного обеспечения Configuration Manager.

Синтаксис

Set-CMPackageDeployment
   [-AllowFallback <Boolean>]
   [-AllowSharedContent <Boolean>]
   [-Comment <String>]
   [-DeploymentAvailableDateTime <DateTime>]
   [-DeploymentExpireDateTime <DateTime>]
   [-EnableExpireSchedule <Boolean>]
   [-FastNetworkOption <FastNetworkOptionType>]
   -InputObject <IResultObject>
   [-PersistOnWriteFilterDevice <Boolean>]
   [-RerunBehavior <RerunBehaviorType>]
   [-RunFromSoftwareCenter <Boolean>]
   [-Schedule <IResultObject[]>]
   [-ScheduleEvent <ScheduleEventType[]>]
   [-SendWakeupPacket <Boolean>]
   [-SlowNetworkOption <SlowNetworkOptionType>]
   [-SoftwareInstallation <Boolean>]
   -StandardProgramName <String>
   [-SystemRestart <Boolean>]
   [-UseMeteredNetwork <Boolean>]
   [-UseUtcForAvailableSchedule <Boolean>]
   [-UseUtcForExpireSchedule <Boolean>]
   [-PassThru]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMPackageDeployment
   [-AllowFallback <Boolean>]
   [-AllowSharedContent <Boolean>]
   [-Comment <String>]
   [-DeploymentAvailableDateTime <DateTime>]
   [-DeploymentExpireDateTime <DateTime>]
   [-EnableExpireSchedule <Boolean>]
   [-FastNetworkOption <FastNetworkOptionType>]
   -PackageName <String>
   [-PersistOnWriteFilterDevice <Boolean>]
   [-RerunBehavior <RerunBehaviorType>]
   [-RunFromSoftwareCenter <Boolean>]
   [-Schedule <IResultObject[]>]
   [-ScheduleEvent <ScheduleEventType[]>]
   [-SendWakeupPacket <Boolean>]
   [-SlowNetworkOption <SlowNetworkOptionType>]
   [-SoftwareInstallation <Boolean>]
   -StandardProgramName <String>
   [-SystemRestart <Boolean>]
   [-UseMeteredNetwork <Boolean>]
   [-UseUtcForAvailableSchedule <Boolean>]
   [-UseUtcForExpireSchedule <Boolean>]
   [-PassThru]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMPackageDeployment
   [-AllowFallback <Boolean>]
   [-AllowSharedContent <Boolean>]
   [-Comment <String>]
   [-DeploymentAvailableDateTime <DateTime>]
   [-DeploymentExpireDateTime <DateTime>]
   [-EnableExpireSchedule <Boolean>]
   [-FastNetworkOption <FastNetworkOptionType>]
   -PackageId <String>
   [-PersistOnWriteFilterDevice <Boolean>]
   [-RerunBehavior <RerunBehaviorType>]
   [-RunFromSoftwareCenter <Boolean>]
   [-Schedule <IResultObject[]>]
   [-ScheduleEvent <ScheduleEventType[]>]
   [-SendWakeupPacket <Boolean>]
   [-SlowNetworkOption <SlowNetworkOptionType>]
   [-SoftwareInstallation <Boolean>]
   -StandardProgramName <String>
   [-SystemRestart <Boolean>]
   [-UseMeteredNetwork <Boolean>]
   [-UseUtcForAvailableSchedule <Boolean>]
   [-UseUtcForExpireSchedule <Boolean>]
   [-PassThru]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMPackageDeployment
   [-Comment <String>]
   [-DeploymentStartDateTime <DateTime>]
   -DeviceProgramName <String>
   -PackageName <String>
   [-RecurUnit <RecurUnitType>]
   [-RecurValue <Int32>]
   [-Rerun <Boolean>]
   [-UseMeteredNetwork <Boolean>]
   [-UseRecurrencePattern <Boolean>]
   [-UseUtc <Boolean>]
   [-PassThru]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMPackageDeployment
   [-Comment <String>]
   [-DeploymentStartDateTime <DateTime>]
   -DeviceProgramName <String>
   -PackageId <String>
   [-RecurUnit <RecurUnitType>]
   [-RecurValue <Int32>]
   [-Rerun <Boolean>]
   [-UseMeteredNetwork <Boolean>]
   [-UseRecurrencePattern <Boolean>]
   [-UseUtc <Boolean>]
   [-PassThru]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMPackageDeployment
   [-Comment <String>]
   [-DeploymentStartDateTime <DateTime>]
   -DeviceProgramName <String>
   -InputObject <IResultObject>
   [-RecurUnit <RecurUnitType>]
   [-RecurValue <Int32>]
   [-Rerun <Boolean>]
   [-UseMeteredNetwork <Boolean>]
   [-UseRecurrencePattern <Boolean>]
   [-UseUtc <Boolean>]
   [-PassThru]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Описание

Командлет Set-CMPackageDeployment изменяет значения, определяющие способ развертывания пакета программного обеспечения Configuration Manager. Развертывание включает в себя коллекцию устройств или пользователей, пакет для развертывания, а также имя программы устройства или стандартное имя программы. Чтобы указать, какое развертывание следует изменить, укажите имя коллекции, пакет и имя программы. Вы можете указать пакет по имени или идентификатору или с помощью командлета Get-CMPackage , чтобы получить объект пакета.

Примечание.

Запустите командлеты Configuration Manager с диска сайта Configuration Manager, например PS XYZ:\>. Дополнительные сведения см. в статье Начало работы.

Примеры

Пример 1. Задание свойств повторения

PS XYZ:\> Set-CMPackageDeployment -CollectionName "All Systems" -DeviceProgramName "DPM" -PackageName "User State Migration Tool for Windows 8" -RecurUnit Hours -RecurValue 7 -UseRecurrencePattern $True

Эта команда вносит изменения в развертывание, указанное в коллекции All Systems, программе устройства DPM и пакете с именем User State Migration Tool для Windows 8. Команда задает для параметра UseRecurrencePattern значение $True. Команда задает единицу рекурса в часах и значение рекурса в семь. Таким образом, развертывание повторяется каждые семь часов.

Пример 2. Установка дня и времени доступности

PS XYZ:\> Set-CMPackageDeployment -CollectionName "All Systems" -PackageName "User State Migration Tool for Windows 8" -StandardProgramName "SPM" -DeploymentAvailableDay 2012/10/18 -DeploymentAvailableTime 15:41 -UseUtcForAvailableSchedule $False

Эта команда вносит изменения в развертывание, указанное в коллекции All Systems, пакете с именем User State Migration Tool для Windows 8 и стандартной программе SPM. Команда указывает день и время, когда развертывание станет доступным. Команда также указывает, что развертывание не использует UTC для расписания доступности. Расписание ссылается на местный часовой пояс.

Параметры

-AllowFallback

{{ Fill AllowFallback Description }}

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

-AllowSharedContent

Указывает, используют ли клиенты общее содержимое. Если это значение равно $True, клиенты пытаются скачать содержимое из других клиентов, скачанных это содержимое. Если это значение равно $False, клиенты не пытаются скачать с других клиентов.

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

-Collection

Указывает коллекцию пользователей.

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

-CollectionId

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

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

-CollectionName

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

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

-Comment

Указывает комментарий для развертывания.

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

-Confirm

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

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

-DeploymentAvailableDateTime

Указывает в качестве объекта DateTime дату и время, когда развертывание станет доступным. Чтобы получить объект DateTime , используйте командлет Get-Date.

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

-DeploymentExpireDateTime

Указывает в качестве объекта DateTime дату и время истечения срока действия развертывания. Чтобы получить объект DateTime , используйте командлет Get-Date .

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

-DeploymentStartDateTime

Указывает в качестве объекта DateTime дату и время начала развертывания. Чтобы получить объект DateTime , используйте командлет Get-Date .

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

-DeviceProgramName

Указывает имя программы устройства.

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

-DisableWildcardHandling

Этот параметр обрабатывает подстановочные знаки как литеральные символы. Вы не можете объединить его с ForceWildcardHandling.

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

-EnableExpireSchedule

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

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

-FastNetworkOption

Указывает поведение клиента в быстрой сети. Допустимые значения для этого параметра:

  • DownloadContentFromDistributionPointAndRunLocally
  • RunProgramFromDistributionPoint
Тип:FastNetworkOptionType
Допустимые значения:RunProgramFromDistributionPoint, DownloadContentFromDistributionPointAndRunLocally
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-ForceWildcardHandling

Этот параметр обрабатывает подстановочные знаки и может привести к непредвиденному поведению (не рекомендуется). Его нельзя объединить с DisableWildcardHandling.

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

-InputObject

Указывает объект пакета.

Тип:IResultObject
Aliases:Package, DeploymentSummary, Advertisement
Position:Named
Default value:None
Обязательно:True
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-PackageId

Указывает идентификатор пакета.

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

-PackageName

Указывает имя пакета.

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

-PassThru

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

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

-PersistOnWriteFilterDevice

Указывает, следует ли включать фильтры записи для внедренных устройств. Для значения $True устройство фиксирует изменения во время периода обслуживания. Для этого действия требуется перезагрузка. Для значения $False устройство сохраняет изменения в наложении и фиксирует их позже.

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

-RecurUnit

Задает единицу для повторяющегося развертывания. Допустимые значения для этого параметра:

  • Дни
  • Часы
  • Минуты
Тип:RecurUnitType
Допустимые значения:Minutes, Hours, Days
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-RecurValue

Указывает частоту повторения развертывания. Этот параметр зависит от типа единицы измерения, указанного в параметре RecurUnit . Это значение может находиться в диапазоне от 1 до 23, если единица измерения — Часы, от 1 до 31, если единица — Days, или от 1 до 59, если единица измерения — Minutes.

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

-Rerun

Указывает, выполняется ли развертывание повторно. Если это значение $True, развертывание выполняется снова для клиентов, как указано в параметре RerunBehavior . Если это значение равно $False, развертывание больше не запускается.

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

-RerunBehavior

Указывает способ повторного запуска развертывания на клиенте. Допустимые значения для этого параметра:

  • AlwaysRerunProgram. Повторно запустите по расписанию, даже если развертывание прошло успешно. Это значение можно использовать для повторяющихся развертываний.
  • NeverRerunDeployedProgram. Не выполняется повторно, даже если развертывание завершилось сбоем или файлы были изменены.
  • RerunIfFailedPreviousAttempt. Повторно запустите по расписанию, если развертывание завершилось сбоем при предыдущей попытке.
  • RerunIfSucceededOnpreviousAttempt. Повторно выполняется только в том случае, если предыдущая попытка выполнена успешно. Это значение можно использовать для обновлений, которые зависят от предыдущего обновления.
Тип:RerunBehaviorType
Допустимые значения:NeverRerunDeployedProgram, AlwaysRerunProgram, RerunIfFailedPreviousAttempt, RerunIfSucceededOnPreviousAttempt
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-RunFromSoftwareCenter

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

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

-Schedule

Указывает объект CMSchedule . Расписание указывает, когда наступает период обслуживания. Чтобы создать объект CMSchedule , используйте командлет New-CMSchedule .

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

-ScheduleEvent

Задает массив типов событий расписания. Допустимые значения для этого параметра:

  • AsSoonAsPossible
  • Выхода
  • LogOn
  • SendWakeUpPacket
Тип:ScheduleEventType[]
Допустимые значения:AsSoonAsPossible, LogOn, LogOff
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-SendWakeupPacket

Указывает, следует ли отправлять пакет пробуждения компьютерам перед началом развертывания. Если это значение равно $True, Configuration Manager выводит компьютер из спящего режима. Если это значение равно $False, оно не выводит компьютеры из спящего режима. Для пробуждения компьютеров необходимо сначала настроить пробуждение по локальной сети.

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

-SlowNetworkOption

Указывает, как Configuration Manager развертывает этот пакет в медленной сети. Допустимые значения для этого параметра:

  • DoNotRunProgram
  • DownloadContentFromDistributionPointAndLocally
  • RunProgramFromDistributionPoint
Тип:SlowNetworkOptionType
Допустимые значения:DoNotRunProgram, DownloadContentFromDistributionPointAndLocally, RunProgramFromDistributionPoint
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-SoftwareInstallation

Указывает, следует ли устанавливать развернутые программы за пределами периодов обслуживания. Период обслуживания — это указанный период времени, используемый для обслуживания и обновлений компьютера. Если это значение равно $True, Configuration Manager устанавливает программное обеспечение по расписанию, даже если расписание выходит за пределы периода обслуживания. Если это значение равно $False, Configuration Manager не устанавливает развернутое программное обеспечение за пределами каких-либо окон, но ожидает периода обслуживания.

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

-StandardProgramName

Задает стандартное имя программы.

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

-SystemRestart

Указывает, перезагружается ли система за пределами периода обслуживания. Период обслуживания — это указанный период времени, используемый для обслуживания и обновлений компьютера. Если это значение $True, любая требуемая перезагрузка выполняется без учета периодов обслуживания. Если это значение равно $False, компьютер не перезагружается за пределами периода обслуживания.

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

-UseMeteredNetwork

{{ Fill UseMeteredNetwork Description }}

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

-UseRecurrencePattern

Указывает, следует ли использовать шаблон повторения.

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

-UseUtc

Указывает, следует ли использовать координированное универсальное время (UTC), также известное как среднее время по Гринвичу. Если это значение равно $True, Configuration Manager использует utc для этого развертывания. Если это значение равно $False, Configuration Manager использует местное время.

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

-UseUtcForAvailableSchedule

Указывает, следует ли использовать UTC для доступного расписания. Если это значение равно $True, Configuration Manager использует UTC. Если это значение равно $False, Configuration Manager использует местное время.

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

-UseUtcForExpireSchedule

Указывает, следует ли использовать UTC для истечения срока действия. Если это значение равно $True, Configuration Manager использует UTC. Если это значение равно $False, Configuration Manager использует местное время.

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

-WhatIf

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

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

Входные данные

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Выходные данные

System.Object