Start-CMPackageDeployment

Модуль:

ConfigurationManager

(Неуловимый) Начинается развертывание пакета программного обеспечения в коллекцию Configuration Manager.

Синтаксис

Start-CMPackageDeployment
     [-AllowSharedContent <Boolean>]
     -CollectionName <String>
     [-Comment <String>]
     [-DeploymentAvailableDateTime <DateTime>]
     [-DeploymentAvailableDay <DateTime>]
     [-DeploymentAvailableTime <DateTime>]
     [-DeploymentExpireDateTime <DateTime>]
     [-DeploymentExpireDay <DateTime>]
     [-DeploymentExpireTime <DateTime>]
     [-DeployPurpose <DeployPurposeType>]
     [-FastNetworkOption <FastNetworkOptionType>]
     [-Package] <IResultObject>
     [-PassThru]
     [-PersistOnWriteFilterDevice <Boolean>]
     -ProgramName <String>
     [-RerunBehavior <RerunBehaviorType>]
     [-RunFromSoftwareCenter <Boolean>]
     [-Schedule <IResultObject[]>]
     [-ScheduleEvent <ScheduleEventType>]
     [-SendWakeupPacket <Boolean>]
     [-SlowNetworkOption <SlowNetworkOptionType>]
     [-SoftwareInstallation <Boolean>]
     [-StandardProgram]
     [-SystemRestart <Boolean>]
     [-UseMeteredNetwork <Boolean>]
     [-UseUtcForAvailableSchedule <Boolean>]
     [-UseUtcForExpireSchedule <Boolean>]
     [-DisableWildcardHandling]
     [-ForceWildcardHandling]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Start-CMPackageDeployment
     [-AllowSharedContent <Boolean>]
     -CollectionName <String>
     [-Comment <String>]
     [-DeploymentAvailableDateTime <DateTime>]
     [-DeploymentAvailableDay <DateTime>]
     [-DeploymentAvailableTime <DateTime>]
     [-DeploymentExpireDateTime <DateTime>]
     [-DeploymentExpireDay <DateTime>]
     [-DeploymentExpireTime <DateTime>]
     [-DeployPurpose <DeployPurposeType>]
     [-FastNetworkOption <FastNetworkOptionType>]
     -PackageName <String>
     [-PassThru]
     [-PersistOnWriteFilterDevice <Boolean>]
     -ProgramName <String>
     [-RerunBehavior <RerunBehaviorType>]
     [-RunFromSoftwareCenter <Boolean>]
     [-Schedule <IResultObject[]>]
     [-ScheduleEvent <ScheduleEventType>]
     [-SendWakeupPacket <Boolean>]
     [-SlowNetworkOption <SlowNetworkOptionType>]
     [-SoftwareInstallation <Boolean>]
     [-StandardProgram]
     [-SystemRestart <Boolean>]
     [-UseMeteredNetwork <Boolean>]
     [-UseUtcForAvailableSchedule <Boolean>]
     [-UseUtcForExpireSchedule <Boolean>]
     [-DisableWildcardHandling]
     [-ForceWildcardHandling]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Start-CMPackageDeployment
     [-AllowSharedContent <Boolean>]
     -CollectionName <String>
     [-Comment <String>]
     [-DeploymentAvailableDateTime <DateTime>]
     [-DeploymentAvailableDay <DateTime>]
     [-DeploymentAvailableTime <DateTime>]
     [-DeploymentExpireDateTime <DateTime>]
     [-DeploymentExpireDay <DateTime>]
     [-DeploymentExpireTime <DateTime>]
     [-DeployPurpose <DeployPurposeType>]
     [-FastNetworkOption <FastNetworkOptionType>]
     -PackageId <String>
     [-PassThru]
     [-PersistOnWriteFilterDevice <Boolean>]
     -ProgramName <String>
     [-RerunBehavior <RerunBehaviorType>]
     [-RunFromSoftwareCenter <Boolean>]
     [-Schedule <IResultObject[]>]
     [-ScheduleEvent <ScheduleEventType>]
     [-SendWakeupPacket <Boolean>]
     [-SlowNetworkOption <SlowNetworkOptionType>]
     [-SoftwareInstallation <Boolean>]
     [-StandardProgram]
     [-SystemRestart <Boolean>]
     [-UseMeteredNetwork <Boolean>]
     [-UseUtcForAvailableSchedule <Boolean>]
     [-UseUtcForExpireSchedule <Boolean>]
     [-DisableWildcardHandling]
     [-ForceWildcardHandling]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Start-CMPackageDeployment
     [-AllowSharedContent <Boolean>]
     -CollectionName <String>
     [-Comment <String>]
     [-DeploymentAvailableDateTime <DateTime>]
     [-DeploymentAvailableDay <DateTime>]
     [-DeploymentAvailableTime <DateTime>]
     [-DeploymentExpireDateTime <DateTime>]
     [-DeploymentExpireDay <DateTime>]
     [-DeploymentExpireTime <DateTime>]
     [-DeployPurpose <DeployPurposeType>]
     [-FastNetworkOption <FastNetworkOptionType>]
     [-PassThru]
     [-PersistOnWriteFilterDevice <Boolean>]
     [-Program] <IResultObject>
     [-RerunBehavior <RerunBehaviorType>]
     [-RunFromSoftwareCenter <Boolean>]
     [-Schedule <IResultObject[]>]
     [-ScheduleEvent <ScheduleEventType>]
     [-SendWakeupPacket <Boolean>]
     [-SlowNetworkOption <SlowNetworkOptionType>]
     [-SoftwareInstallation <Boolean>]
     [-StandardProgram]
     [-SystemRestart <Boolean>]
     [-UseMeteredNetwork <Boolean>]
     [-UseUtcForAvailableSchedule <Boolean>]
     [-UseUtcForExpireSchedule <Boolean>]
     [-DisableWildcardHandling]
     [-ForceWildcardHandling]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Start-CMPackageDeployment
     -CollectionName <String>
     [-Comment <String>]
     [-DeploymentStartDateTime <DateTime>]
     [-DeploymentStartDay <DateTime>]
     [-DeploymentStartTime <DateTime>]
     [-DeployPurpose <DeployPurposeType>]
     [-DeviceProgram]
     -PackageName <String>
     [-PassThru]
     -ProgramName <String>
     [-RecurUnit <RecurUnitType>]
     [-RecurValue <Int32>]
     [-Rerun <Boolean>]
     [-UseMeteredNetwork <Boolean>]
     [-UseUtc <Boolean>]
     [-DisableWildcardHandling]
     [-ForceWildcardHandling]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Start-CMPackageDeployment
     -CollectionName <String>
     [-Comment <String>]
     [-DeploymentStartDateTime <DateTime>]
     [-DeploymentStartDay <DateTime>]
     [-DeploymentStartTime <DateTime>]
     [-DeployPurpose <DeployPurposeType>]
     [-DeviceProgram]
     -PackageId <String>
     [-PassThru]
     -ProgramName <String>
     [-RecurUnit <RecurUnitType>]
     [-RecurValue <Int32>]
     [-Rerun <Boolean>]
     [-UseMeteredNetwork <Boolean>]
     [-UseUtc <Boolean>]
     [-DisableWildcardHandling]
     [-ForceWildcardHandling]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Start-CMPackageDeployment
     -CollectionName <String>
     [-Comment <String>]
     [-DeploymentStartDateTime <DateTime>]
     [-DeploymentStartDay <DateTime>]
     [-DeploymentStartTime <DateTime>]
     [-DeployPurpose <DeployPurposeType>]
     [-DeviceProgram]
     [-Package] <IResultObject>
     [-PassThru]
     -ProgramName <String>
     [-RecurUnit <RecurUnitType>]
     [-RecurValue <Int32>]
     [-Rerun <Boolean>]
     [-UseMeteredNetwork <Boolean>]
     [-UseUtc <Boolean>]
     [-DisableWildcardHandling]
     [-ForceWildcardHandling]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Start-CMPackageDeployment
     -CollectionName <String>
     [-Comment <String>]
     [-DeploymentStartDateTime <DateTime>]
     [-DeploymentStartDay <DateTime>]
     [-DeploymentStartTime <DateTime>]
     [-DeployPurpose <DeployPurposeType>]
     [-DeviceProgram]
     [-PassThru]
     [-Program] <IResultObject>
     [-RecurUnit <RecurUnitType>]
     [-RecurValue <Int32>]
     [-Rerun <Boolean>]
     [-SendWakeupPacket <Boolean>]
     [-UseMeteredNetwork <Boolean>]
     [-UseUtc <Boolean>]
     [-DisableWildcardHandling]
     [-ForceWildcardHandling]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Описание

Важно!

Этот комдлет отстает. Вместо этого используйте New-CMPackageDeployment.

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

Примечание

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

Примеры

Пример 1. Запуск повторяющегося развертывания

PS XYZ:\> Start-CMPackageDeployment -CollectionName "All Systems" -DeviceProgramName "DPM" -PackageName "User State Migration Tool for Windows 8" -Comment "DPM for all systems." -DeploymentStartDay 2012/10/26 -DeploymentStartTime 12:12 -RecurUnit Days -RecurValue 7 -Rerun $True -UseMeteredNetwork $True -UseUtc $True

Эта команда запускает развертывание именного пакета в коллекцию All Systems для программы устройств с именем DPM. Команда указывает день начала и время начала. Команда содержит описательный комментарий. Параметр Rerun имеет значение $True, а команда указывает значение повтора в семь и повторную единицу Дней, поэтому развертывание повторяется каждые семь дней. В развертывании используется сеть со счетчиками. Развертывание использует время UTC.

Пример 2. Запуск повторяющегося развертывания для доступного пакета

PS XYZ:\> Start-CMPackageDeployment -CollectionName "Western Computers" -DeviceProgramName "DPM" -PackageName "User State Migration Tool for Windows 8" -Comment "Deployment for Western office." -DeployPurpose Available -Rerun $True -UseUtc $True

Эта команда начинает развертывание для пакета с именем в коллекцию с именем Western Computers для программы устройств с именем DPM. Команда содержит описательный комментарий. Команда указывает Доступные как DeployPurpose, поэтому пользователи могут решить, следует ли устанавливать это программное обеспечение. Параметр Rerun имеет значение $True. Развертывание использует время UTC.

Пример 3. Запуск развертывания для стандартной программы

PS XYZ:\> Start-CMPackageDeployment -CollectionName "All Systems" -PackageName "User State Migration Tool for Windows 8" -StandardProgramName "SPM" AllowSharedContent $False

Эта команда запускает развертывание пакета с именем Средство миграции состояния пользователя для Windows 8 в коллекцию с именем All Systems для стандартной программы с именем SPM. Команда не позволяет компьютерам использовать общий контент.

Параметры

- Название пакета

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

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

-AllowSharedContent

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

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

-CollectionName

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

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

-Comment

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

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

-Confirm

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

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DeploymentAvailableDateTime

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

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

-DeploymentAvailableDay

Устаревший. Использование DeploymentAvailableDateTime.

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

-DeploymentAvailableTime

Устаревший. Вместо этого используйте deploymentAvailableDateTime.

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

-DeploymentExpireDateTime

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

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

-DeploymentExpireDay

Устаревший. Вместо этого используйте deploymentExpireDateTime.

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

-DeploymentExpireTime

Устаревший. Использование DeploymentExpireDateTime.

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

-DeploymentStartDateTime

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

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

-DeploymentStartDay

Устаревший. Использование DeploymentStartDateTime.

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

-DeploymentStartTime

Устаревший. Использование DeploymentStartDateTime.

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

-DeployPurpose

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

• Доступно
• Обязательна

Type:	DeployPurposeType
Accepted values:	Available, Required
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-DeviceProgram

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

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

-DisableWildcardHandling

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

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

-FastNetworkOption

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

• DownloadContentFromDistributionPointAndRunLocally
• RunProgramFromDistributionPoint

Type:	FastNetworkOptionType
Accepted values:	RunProgramFromDistributionPoint, DownloadContentFromDistributionPointAndRunLocally
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-ForceWildcardHandling

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

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

-Package

Указывает объект пакета. Чтобы получить объект пакета, используйте комлет Get-CMPackage.

Type:	IResultObject
Position:	0
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-PackageId

Указывает ID пакета.

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

-PassThru

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

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

-PersistOnWriteFilterDevice

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

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

-Program

Указывает программу.

Type:	IResultObject
Position:	0
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-ProgramName

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

Type:	String
Aliases:	StandardProgramName, DeviceProgramName
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-RecurUnit

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

• Дни
• Часы
• Минуты

Type:	RecurUnitType
Accepted values:	Minutes, Hours, Days
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-RecurValue

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

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

-Rerun

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

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

-RerunBehavior

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

• AlwaysRerunProgram. Перезахоранить по расписанию, даже если развертывание успешно. Это значение можно использовать для повторяющихся развертывания.
• NeverRerunDeployedProgram. Не перезапев, даже если развертывание не удалось или файлы изменились.
• RerunIfFailedPreviousAttempt. Повторно, как и планировалось, если развертывание не удалось во время предыдущей попытки.
• RerunIfSucceededOnpreviousAttempt. Перезахоранить только в том случае, если предыдущая попытка была успешной. Это значение можно использовать для обновлений, которые зависят от предыдущего обновления.

Type:	RerunBehaviorType
Accepted values:	NeverRerunDeployedProgram, AlwaysRetunProgram, AlwaysRerunProgram, RerunIfFailedPreviousAttempt, RerunIfSucceededOnPreviousAttempt
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-RunFromSoftwareCenter

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

Type:	Boolean
Aliases:	AllowUsersRunIndependently
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-Schedule

Указывает объект расписания для развертывания.

Type:	IResultObject[]
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-ScheduleEvent

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

• AsSoonAsPossible
• LogOff
• LogOn
• SendWakeUpPacket

Type:	ScheduleEventType
Accepted values:	AsSoonAsPossible, LogOn, LogOff
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-SendWakeupPacket

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

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

-SlowNetworkOption

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

• DoNotRunProgram
• DownloadContentFromDistributionPointAndLocally
• RunProgramFromDistributionPoint

Type:	SlowNetworkOptionType
Accepted values:	DoNotRunProgram, DownloadContentFromDistributionPointAndLocally, RunProgramFromDistributionPoint
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-SoftwareInstallation

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

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

-StandardProgram

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

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

-SystemRestart

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

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

-UseMeteredNetwork

Указывает, следует ли разрешить клиентам скачивать контент через дозное подключение к Интернету после крайнего срока, что может понести дополнительные расходы.

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

-UseUtc

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

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

-UseUtcForAvailableSchedule

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

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

-UseUtcForExpireSchedule

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

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

-WhatIf

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

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	False
Accept pipeline input:	False
Accept wildcard characters:	False

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

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

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

System.Object

Связанные ссылки

• New-CMPackageDeployment
• Get-CMPackageDeployment
• Get-CMPackageDeploymentStatus
• Set-CMPackageDeployment
• Remove-CMPackageDeployment
• Get-CMPackage