Set-CMPackageDeployment
Изменяет значения, определяющие способ развертывания пакета программного обеспечения 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