New-CMPackageDeployment

Развертывание устаревшего пакета в коллекцию.

Синтаксис

New-CMPackageDeployment
   [-AllowFallback <Boolean>]
   [-AllowSharedContent <Boolean>]
   [-DeployPurpose <DeployPurposeType>]
   [-FastNetworkOption <FastNetworkOptionType>]
   [-Package] <IResultObject>
   [-PersistOnWriteFilterDevice <Boolean>]
   -ProgramName <String>
   [-RerunBehavior <RerunBehaviorType>]
   [-RunFromSoftwareCenter <Boolean>]
   [-Schedule <IResultObject[]>]
   [-ScheduleEvent <ScheduleEventType>]
   [-SendWakeupPacket <Boolean>]
   [-SlowNetworkOption <SlowNetworkOptionType>]
   [-SoftwareInstallation <Boolean>]
   [-StandardProgram]
   [-SystemRestart <Boolean>]
   [-UseUtcForAvailableSchedule <Boolean>]
   [-UseUtcForExpireSchedule <Boolean>]
   [-DistributeCollectionName <String>]
   [-DistributeContent]
   [-DistributionPointGroupName <String>]
   [-DistributionPointName <String>]
   [-AvailableDateTime <DateTime>]
   [-Comment <String>]
   [-DeadlineDateTime <DateTime>]
   [-UseMeteredNetwork <Boolean>]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-CMPackageDeployment
   [-AllowFallback <Boolean>]
   [-AllowSharedContent <Boolean>]
   [-DeployPurpose <DeployPurposeType>]
   [-FastNetworkOption <FastNetworkOptionType>]
   -PackageName <String>
   [-PersistOnWriteFilterDevice <Boolean>]
   -ProgramName <String>
   [-RerunBehavior <RerunBehaviorType>]
   [-RunFromSoftwareCenter <Boolean>]
   [-Schedule <IResultObject[]>]
   [-ScheduleEvent <ScheduleEventType>]
   [-SendWakeupPacket <Boolean>]
   [-SlowNetworkOption <SlowNetworkOptionType>]
   [-SoftwareInstallation <Boolean>]
   [-StandardProgram]
   [-SystemRestart <Boolean>]
   [-UseUtcForAvailableSchedule <Boolean>]
   [-UseUtcForExpireSchedule <Boolean>]
   [-DistributeCollectionName <String>]
   [-DistributeContent]
   [-DistributionPointGroupName <String>]
   [-DistributionPointName <String>]
   [-AvailableDateTime <DateTime>]
   [-Comment <String>]
   [-DeadlineDateTime <DateTime>]
   [-UseMeteredNetwork <Boolean>]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-CMPackageDeployment
   [-AllowFallback <Boolean>]
   [-AllowSharedContent <Boolean>]
   [-DeployPurpose <DeployPurposeType>]
   [-FastNetworkOption <FastNetworkOptionType>]
   -PackageId <String>
   [-PersistOnWriteFilterDevice <Boolean>]
   -ProgramName <String>
   [-RerunBehavior <RerunBehaviorType>]
   [-RunFromSoftwareCenter <Boolean>]
   [-Schedule <IResultObject[]>]
   [-ScheduleEvent <ScheduleEventType>]
   [-SendWakeupPacket <Boolean>]
   [-SlowNetworkOption <SlowNetworkOptionType>]
   [-SoftwareInstallation <Boolean>]
   [-StandardProgram]
   [-SystemRestart <Boolean>]
   [-UseUtcForAvailableSchedule <Boolean>]
   [-UseUtcForExpireSchedule <Boolean>]
   [-DistributeCollectionName <String>]
   [-DistributeContent]
   [-DistributionPointGroupName <String>]
   [-DistributionPointName <String>]
   [-AvailableDateTime <DateTime>]
   [-Comment <String>]
   [-DeadlineDateTime <DateTime>]
   [-UseMeteredNetwork <Boolean>]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-CMPackageDeployment
   [-AllowFallback <Boolean>]
   [-AllowSharedContent <Boolean>]
   [-DeployPurpose <DeployPurposeType>]
   [-FastNetworkOption <FastNetworkOptionType>]
   [-PersistOnWriteFilterDevice <Boolean>]
   [-Program] <IResultObject>
   [-RerunBehavior <RerunBehaviorType>]
   [-RunFromSoftwareCenter <Boolean>]
   [-Schedule <IResultObject[]>]
   [-ScheduleEvent <ScheduleEventType>]
   [-SendWakeupPacket <Boolean>]
   [-SlowNetworkOption <SlowNetworkOptionType>]
   [-SoftwareInstallation <Boolean>]
   [-StandardProgram]
   [-SystemRestart <Boolean>]
   [-UseUtcForAvailableSchedule <Boolean>]
   [-UseUtcForExpireSchedule <Boolean>]
   [-DistributeCollectionName <String>]
   [-DistributeContent]
   [-DistributionPointGroupName <String>]
   [-DistributionPointName <String>]
   [-AvailableDateTime <DateTime>]
   [-Comment <String>]
   [-DeadlineDateTime <DateTime>]
   [-UseMeteredNetwork <Boolean>]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-CMPackageDeployment
   [-DeployPurpose <DeployPurposeType>]
   [-DeviceProgram]
   -PackageName <String>
   -ProgramName <String>
   [-RecurUnit <RecurUnitType>]
   [-RecurValue <Int32>]
   [-Rerun <Boolean>]
   [-UseUtc <Boolean>]
   [-DistributeCollectionName <String>]
   [-DistributeContent]
   [-DistributionPointGroupName <String>]
   [-DistributionPointName <String>]
   [-AvailableDateTime <DateTime>]
   [-Comment <String>]
   [-DeadlineDateTime <DateTime>]
   [-UseMeteredNetwork <Boolean>]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-CMPackageDeployment
   [-DeployPurpose <DeployPurposeType>]
   [-DeviceProgram]
   -PackageId <String>
   -ProgramName <String>
   [-RecurUnit <RecurUnitType>]
   [-RecurValue <Int32>]
   [-Rerun <Boolean>]
   [-UseUtc <Boolean>]
   [-DistributeCollectionName <String>]
   [-DistributeContent]
   [-DistributionPointGroupName <String>]
   [-DistributionPointName <String>]
   [-AvailableDateTime <DateTime>]
   [-Comment <String>]
   [-DeadlineDateTime <DateTime>]
   [-UseMeteredNetwork <Boolean>]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-CMPackageDeployment
   [-DeployPurpose <DeployPurposeType>]
   [-DeviceProgram]
   [-Package] <IResultObject>
   -ProgramName <String>
   [-RecurUnit <RecurUnitType>]
   [-RecurValue <Int32>]
   [-Rerun <Boolean>]
   [-UseUtc <Boolean>]
   [-DistributeCollectionName <String>]
   [-DistributeContent]
   [-DistributionPointGroupName <String>]
   [-DistributionPointName <String>]
   [-AvailableDateTime <DateTime>]
   [-Comment <String>]
   [-DeadlineDateTime <DateTime>]
   [-UseMeteredNetwork <Boolean>]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-CMPackageDeployment
   [-DeployPurpose <DeployPurposeType>]
   [-DeviceProgram]
   [-Program] <IResultObject>
   [-RecurUnit <RecurUnitType>]
   [-RecurValue <Int32>]
   [-Rerun <Boolean>]
   [-SendWakeupPacket <Boolean>]
   [-UseUtc <Boolean>]
   [-DistributeCollectionName <String>]
   [-DistributeContent]
   [-DistributionPointGroupName <String>]
   [-DistributionPointName <String>]
   [-AvailableDateTime <DateTime>]
   [-Comment <String>]
   [-DeadlineDateTime <DateTime>]
   [-UseMeteredNetwork <Boolean>]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Описание

Этот комлет используется для развертывания пакета для ресурсов в коллекции. Вы можете указать коллекцию по ID, имени или передать объект.

Для других параметров развертывания, которые нельзя настроить с помощью этого комлета, используйте Set-CMPackageDeployment.

Дополнительные сведения см. в программе Packages and programs in Configuration Manager.

Примечание

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

Примеры

Пример 1. Развертывание пакета по ID

Эта команда создает развертывание пакета с ID XYZ00001 в коллекцию с ID XYZ0003F.

$pkgId = "XYZ00001"
$collId = "XYZ0003F"
New-CMPackageDeployment -StandardProgram -PackageId $pkgId -ProgramName "ScanState" -CollectionID $collId -Comment "Use USMT to scan for data" -DeployPurpose Available

Пример 2. Развертывание пакета по мере необходимости с крайним сроком

Первая команда задает переменную на крайний срок до 10 дней с этого времени в 20:00. Вторая команда создает объект расписания на основе этого срока, который повторяется ежедневно. Третья команда создает развертывание пакета с таким расписанием.

[datetime]$DeadlineTime = (Get-Date -Hour 20 -Minute 0 -Second 0).AddDays(10)

$NewScheduleDeadline = New-CMSchedule -Start $DeadlineTime -Nonrecurring

$pkgId = "XYZ00001"
$progName = "Run"
$collId = "XYZ0003F"

New-CMPackageDeployment -StandardProgram -PackageId $pkgId -ProgramName $progName -DeployPurpose Required -CollectionId $collId -FastNetworkOption DownloadContentFromDistributionPointAndRunLocally -SlowNetworkOption DownloadContentFromDistributionPointAndLocally -RerunBehavior RerunIfFailedPreviousAttempt -Schedule $NewScheduleDeadline

Параметры

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

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

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

-AllowFallback

Разрешить клиентам использовать точки распространения из группы границ сайтов по умолчанию.

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

-AllowSharedContent

Разрешить клиентам использовать точки распространения из пограничной группы соседей.

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

-AvailableDateTime

Укажите, когда это развертывание доступно.

Используйте -DeadlineDateTime, чтобы указать, когда истекает срок развертывания, и -Schedule указать назначение развертывания или крайний срок.

Чтобы получить объект DateTime, используйте комлет Get-Date.

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

-Collection

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

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

-CollectionId

В качестве целевой цели для развертывания этого пакета укажите ИД коллекции.

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

-CollectionName

В качестве цели для развертывания этого пакета укажите имя коллекции.

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

-Comment

Укажите необязательный комментарий для развертывания этого пакета.

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

-Confirm

Добавьте этот параметр для запроса подтверждения перед запуском cmdlet.

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

-DeadlineDateTime

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

Используйте -AvailableDateTime, чтобы указать, когда развертывание доступно, и -Расписание, чтобы указать назначение развертывания или крайний срок.

Чтобы получить объект DateTime, используйте комлет Get-Date.

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

Если программа для развертываемого пакета — это программа типа устройства, укажите этот параметр.

В противном случае используйте параметр StandardProgram. Стандартный тип программы для компьютеров с клиентом Configuration Manager.

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

-DistributeCollectionName

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

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

-DistributeContent

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

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

-DistributionPointGroupName

Сайт распространяет контент в эту группу точеки рассылки.

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

-DistributionPointName

Сайт распространяет контент в эту точку распространения.

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

-FastNetworkOption

Укажите поведение, когда клиент использует точку рассылки из текущей пограничной группы:

  • Запуск программы из точки распространения
  • Скачайте контент из точки распространения и запустите локально

Если этот параметр не указан, он используется по DownloadContentFromDistributionPointAndRunLocally умолчанию. Этот параметр является более безопасным, так как клиент проверяет hash контента перед запуском программы.

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 пакета с развертываемой программой. Этот ID является стандартным ID пакета, например XYZ007E3 .

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

-PersistOnWriteFilterDevice

Настройка обработки клиентом фильтра записи на Windows встроенных устройств.

  • $true: Внести изменения в срок или во время окна обслуживания. Требуется перезапуск.
  • $false: Нанесите содержимое на наложение и зафиксировать позже.
Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-Program

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

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

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

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

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

  • NeverRerunDeployedProgram. Не повторно, даже если развертывание не удалось или файлы изменились.
  • AlwaysRerunProgram. Повторное развертывание по расписанию, даже если развертывание успешно. Это значение можно использовать для повторяющихся развертывания. Это значение по умолчанию.
  • RerunIfFailedPreviousAttempt. Повторное развертывание по расписанию, если развертывание не удалось во время предыдущей попытки.
  • RerunIfSucceededOnPreviousAttempt. Повторная повторная попытка только в том случае, если предыдущая попытка была успешной.
Type:RerunBehaviorType
Accepted values:NeverRerunDeployedProgram, 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

Используйте этот параметр, чтобы указать назначение развертывания или крайний срок.

Используйте -AvailableDateTime, чтобы указать, когда развертывание доступно, и -DeadlineDateTime , чтобы указать, когда истекает срок развертывания.

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

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

-ScheduleEvent

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

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 умолчанию.

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

-SoftwareInstallation

Когда крайний срок установки достигнут, установите этот параметр, чтобы разрешить установку пакета $true за пределами окна обслуживания.

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

-StandardProgram

Используйте этот параметр для стандартных типов программ. Этот тип для компьютеров с клиентом Configuration Manager.

Если программа для развертываемого пакета — это программа типа устройства, используйте параметр DeviceProgram.

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

-SystemRestart

Когда установлен крайний срок установки, установите этот параметр, чтобы разрешить перезапуск системы при необходимости $true за пределами окна обслуживания.

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) для определения доступности программы. Время UTC делает развертывание доступным одновременно для всех компьютеров. Если этот параметр не указан или задан, клиент $false использует свое локальное время.

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

-UseUtcForAvailableSchedule

Указывает, используют ли клиенты скоординированное универсальное время (UTC) для определения доступности программы. Время UTC делает развертывание доступным одновременно для всех компьютеров. Если этот параметр не указан или задан, клиент $false использует свое локальное время.

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

-UseUtcForExpireSchedule

Указывает, используют ли клиенты скоординированное универсальное время (UTC) для определения срока действия программы. Время развертывания 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:None
Accept pipeline input:False
Accept wildcard characters:False

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

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

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

System.Object