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