New-CMSoftwareUpdateDeployment

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

Синтаксис

New-CMSoftwareUpdateDeployment
   [-AcceptEula]
   [-AllowRestart <Boolean>]
   [-DeploymentName <String>]
   [-DeploymentType <DeploymentType>]
   [-Comment <String>]
   [-DisableOperationsManagerAlert <Boolean>]
   [-DownloadFromMicrosoftUpdate <Boolean>]
   [-GenerateOperationsManagerAlert <Boolean>]
   [-GenerateSuccessAlert <Boolean>]
   -InputObject <IResultObject>
   [-PercentSuccess <Int32>]
   [-ProtectedType <ProtectedType>]
   [-DeployWithNoPackage <Boolean>]
   [-RequirePostRebootFullScan <Boolean>]
   [-RestartServer <Boolean>]
   [-RestartWorkstation <Boolean>]
   [-SavedPackageId <String>]
   [-SoftDeadlineEnabled <Boolean>]
   [-SoftwareInstallation <Boolean>]
   [-TimeBasedOn <TimeType>]
   [-TimeUnit <TimeUnitType>]
   [-TimeValue <Int32>]
   [-UnprotectedType <UnprotectedType>]
   [-UseBranchCache <Boolean>]
   [-UserNotification <UserNotificationType>]
   [-VerbosityLevel <VerbosityLevelType>]
   [-DistributeCollectionName <String>]
   [-DistributeContent]
   [-DistributionPointGroupName <String>]
   [-DistributionPointName <String>]
   [-AvailableDateTime <DateTime>]
   [-DeadlineDateTime <DateTime>]
   [-PersistOnWriteFilterDevice <Boolean>]
   [-SendWakeupPacket <Boolean>]
   [-UseMeteredNetwork <Boolean>]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-CMSoftwareUpdateDeployment
   [-AcceptEula]
   [-AllowRestart <Boolean>]
   [-DeploymentName <String>]
   [-DeploymentType <DeploymentType>]
   [-Comment <String>]
   [-DisableOperationsManagerAlert <Boolean>]
   [-DownloadFromMicrosoftUpdate <Boolean>]
   [-GenerateOperationsManagerAlert <Boolean>]
   [-GenerateSuccessAlert <Boolean>]
   [-PercentSuccess <Int32>]
   [-ProtectedType <ProtectedType>]
   [-DeployWithNoPackage <Boolean>]
   [-RequirePostRebootFullScan <Boolean>]
   [-RestartServer <Boolean>]
   [-RestartWorkstation <Boolean>]
   [-SavedPackageId <String>]
   [-SoftDeadlineEnabled <Boolean>]
   [-SoftwareInstallation <Boolean>]
   -SoftwareUpdateGroupId <String>
   [-TimeBasedOn <TimeType>]
   [-TimeUnit <TimeUnitType>]
   [-TimeValue <Int32>]
   [-UnprotectedType <UnprotectedType>]
   [-UseBranchCache <Boolean>]
   [-UserNotification <UserNotificationType>]
   [-VerbosityLevel <VerbosityLevelType>]
   [-DistributeCollectionName <String>]
   [-DistributeContent]
   [-DistributionPointGroupName <String>]
   [-DistributionPointName <String>]
   [-AvailableDateTime <DateTime>]
   [-DeadlineDateTime <DateTime>]
   [-PersistOnWriteFilterDevice <Boolean>]
   [-SendWakeupPacket <Boolean>]
   [-UseMeteredNetwork <Boolean>]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-CMSoftwareUpdateDeployment
   [-AcceptEula]
   [-AllowRestart <Boolean>]
   [-DeploymentName <String>]
   [-DeploymentType <DeploymentType>]
   [-Comment <String>]
   [-DisableOperationsManagerAlert <Boolean>]
   [-DownloadFromMicrosoftUpdate <Boolean>]
   [-GenerateOperationsManagerAlert <Boolean>]
   [-GenerateSuccessAlert <Boolean>]
   [-PercentSuccess <Int32>]
   [-ProtectedType <ProtectedType>]
   [-DeployWithNoPackage <Boolean>]
   [-RequirePostRebootFullScan <Boolean>]
   [-RestartServer <Boolean>]
   [-RestartWorkstation <Boolean>]
   [-SavedPackageId <String>]
   [-SoftDeadlineEnabled <Boolean>]
   [-SoftwareInstallation <Boolean>]
   -SoftwareUpdateGroupName <String>
   [-TimeBasedOn <TimeType>]
   [-TimeUnit <TimeUnitType>]
   [-TimeValue <Int32>]
   [-UnprotectedType <UnprotectedType>]
   [-UseBranchCache <Boolean>]
   [-UserNotification <UserNotificationType>]
   [-VerbosityLevel <VerbosityLevelType>]
   [-DistributeCollectionName <String>]
   [-DistributeContent]
   [-DistributionPointGroupName <String>]
   [-DistributionPointName <String>]
   [-AvailableDateTime <DateTime>]
   [-DeadlineDateTime <DateTime>]
   [-PersistOnWriteFilterDevice <Boolean>]
   [-SendWakeupPacket <Boolean>]
   [-UseMeteredNetwork <Boolean>]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-CMSoftwareUpdateDeployment
   [-AcceptEula]
   [-AllowRestart <Boolean>]
   [-DeploymentName <String>]
   [-DeploymentType <DeploymentType>]
   [-Comment <String>]
   [-DisableOperationsManagerAlert <Boolean>]
   [-DownloadFromMicrosoftUpdate <Boolean>]
   [-GenerateOperationsManagerAlert <Boolean>]
   [-GenerateSuccessAlert <Boolean>]
   [-PercentSuccess <Int32>]
   [-ProtectedType <ProtectedType>]
   [-DeployWithNoPackage <Boolean>]
   [-RequirePostRebootFullScan <Boolean>]
   [-RestartServer <Boolean>]
   [-RestartWorkstation <Boolean>]
   [-SavedPackageId <String>]
   [-SoftDeadlineEnabled <Boolean>]
   [-SoftwareInstallation <Boolean>]
   -SoftwareUpdateId <String>
   [-TimeBasedOn <TimeType>]
   [-TimeUnit <TimeUnitType>]
   [-TimeValue <Int32>]
   [-UnprotectedType <UnprotectedType>]
   [-UseBranchCache <Boolean>]
   [-UserNotification <UserNotificationType>]
   [-VerbosityLevel <VerbosityLevelType>]
   [-DistributeCollectionName <String>]
   [-DistributeContent]
   [-DistributionPointGroupName <String>]
   [-DistributionPointName <String>]
   [-AvailableDateTime <DateTime>]
   [-DeadlineDateTime <DateTime>]
   [-PersistOnWriteFilterDevice <Boolean>]
   [-SendWakeupPacket <Boolean>]
   [-UseMeteredNetwork <Boolean>]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-CMSoftwareUpdateDeployment
   [-AcceptEula]
   [-AllowRestart <Boolean>]
   [-DeploymentName <String>]
   [-DeploymentType <DeploymentType>]
   [-Comment <String>]
   [-DisableOperationsManagerAlert <Boolean>]
   [-DownloadFromMicrosoftUpdate <Boolean>]
   [-GenerateOperationsManagerAlert <Boolean>]
   [-GenerateSuccessAlert <Boolean>]
   [-PercentSuccess <Int32>]
   [-ProtectedType <ProtectedType>]
   [-DeployWithNoPackage <Boolean>]
   [-RequirePostRebootFullScan <Boolean>]
   [-RestartServer <Boolean>]
   [-RestartWorkstation <Boolean>]
   [-SavedPackageId <String>]
   [-SoftDeadlineEnabled <Boolean>]
   [-SoftwareInstallation <Boolean>]
   -SoftwareUpdateName <String>
   [-TimeBasedOn <TimeType>]
   [-TimeUnit <TimeUnitType>]
   [-TimeValue <Int32>]
   [-UnprotectedType <UnprotectedType>]
   [-UseBranchCache <Boolean>]
   [-UserNotification <UserNotificationType>]
   [-VerbosityLevel <VerbosityLevelType>]
   [-DistributeCollectionName <String>]
   [-DistributeContent]
   [-DistributionPointGroupName <String>]
   [-DistributionPointName <String>]
   [-AvailableDateTime <DateTime>]
   [-DeadlineDateTime <DateTime>]
   [-PersistOnWriteFilterDevice <Boolean>]
   [-SendWakeupPacket <Boolean>]
   [-UseMeteredNetwork <Boolean>]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Описание

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

Примечание.

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

Примеры

Пример 1

New-CMSoftwareUpdateDeployment -DeploymentName "updates deployment" -SoftwareUpdateGroupName "software update group" -CollectionName "Desktop clients for SUM" -Description "a more detailed description of this deployment" -DeploymentType Required -VerbosityLevel AllMessages -AvailableDateTime "2020/08/25 02:00AM" -DeadlineDateTime "2020/08/26 02:00AM" -UserNotification DisplaySoftwareCenterOnly -SoftwareInstallation $True  -AllowRestart $True  -RestartServer $False -RestartWorkstation $False -PersistOnWriteFilterDevice $True -RequirePostRebootFullScan $True -ProtectedType RemoteDistributionPoint

Параметры

-AcceptEula

Некоторые обновления программного обеспечения включают условия лицензии. При развертывании обновлений программного обеспечения условия лицензии не отображаются. Добавьте этот параметр для автоматического развертывания всех обновлений программного обеспечения независимо от соответствующего срока лицензии.

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

-AllowRestart

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

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

-AvailableDateTime

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

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

-Collection

Указывает объект коллекции в Configuration Manager целевого развертывания. Получите этот объект с помощью командлета Get-CMCollection .

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

-CollectionId

Укажите идентификатор коллекции в качестве целевого объекта для этого развертывания обновлений программного обеспечения.

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

-CollectionName

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

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

-Comment

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

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

-Confirm

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

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

-DeadlineDateTime

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

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

-DeploymentName

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

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

-DeploymentType

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

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

-DeployWithNoPackage

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

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

-DisableOperationsManagerAlert

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

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

-DisableWildcardHandling

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

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

-DistributeCollectionName

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

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

-DistributeContent

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

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

-DistributionPointGroupName

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

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

-DistributionPointName

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

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

-DownloadFromMicrosoftUpdate

Если содержимое обновления программного обеспечения недоступно в точке распространения в текущих, соседних группах или группах границ сайта, скачайте содержимое из Центра обновления Майкрософт.

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

-ForceWildcardHandling

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

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

-GenerateOperationsManagerAlert

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

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

-GenerateSuccessAlert

Если соответствие развертывания ниже указанного порогового значения, развертывание создает оповещение в консоли Configuration Manager. Пороговое значение по умолчанию — 95 процентов. Чтобы изменить пороговое значение, используйте параметр PercentSuccess .

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

-InputObject

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

Type:IResultObject
Aliases:SoftwareUpdate, SoftwareUpdateGroup
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-PercentSuccess

Если для параметра -GenerateSuccessAlert задано значение $true, используйте этот параметр для указания порогового значения соответствия, при котором сайт создает оповещение Configuration Manager консоли. Если не указано, сайт создает оповещение, если развертывание не достигает 95 процентов соответствия к указанному крайнему сроку.

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

-PersistOnWriteFilterDevice

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

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

-ProtectedType

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

Type:ProtectedType
Accepted values:NoInstall, RemoteDistributionPoint
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-RequirePostRebootFullScan

Этот параметр управляет следующим параметром консоли: Поведение повторной оценки развертывания обновлений программного обеспечения при перезапуске. Если для этого параметра задано значение $true, после перезапуска клиентов при установке обновлений из этого развертывания они затем запускают полный цикл оценки развертывания обновлений.

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

-RestartServer

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

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

-RestartWorkstation

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

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

-SavedPackageId

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

-SendWakeupPacket

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

  • $True: Configuration Manager выводит компьютер из спящего режима.
  • $False: не выводит компьютеры из спящего режима.

Для пробуждения компьютеров сначала настройте пробуждение по локальной сети.

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

-SoftDeadlineEnabled

Используйте этот параметр, чтобы задать следующий параметр на странице Расписание развертывания параметров развертывания ADR: Задержка принудительного применения этого развертывания в соответствии с пользовательскими предпочтениями до льготного периода, определенного в параметрах клиента.

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

-SoftwareInstallation

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

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

-SoftwareUpdateGroupId

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

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

-SoftwareUpdateGroupName

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

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

-SoftwareUpdateId

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

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

-SoftwareUpdateName

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

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

-TimeBasedOn

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

Type:TimeType
Accepted values:LocalTime, Utc
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-TimeUnit

Укажите тип значения параметра -TimeValue .

Type:TimeUnitType
Accepted values:Hours, Days, Weeks, Months
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-TimeValue

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

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

-UnprotectedType

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

Type:UnprotectedType
Accepted values:NoInstall, UnprotectedDistributionPoint
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-UseBranchCache

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

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

-UseMeteredNetwork

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

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

-UserNotification

Укажите взаимодействие с уведомлениями пользователя.

  • DisplayAll: отображается в Центре программного обеспечения и отображаются все уведомления.
  • DisplaySoftwareCenterOnly: отображается в Центре программного обеспечения и отображаются только уведомления о перезагрузке компьютера.
  • HideAll: скрытие в центре программного обеспечения и всех уведомлений
Type:UserNotificationType
Accepted values:DisplayAll, DisplaySoftwareCenterOnly, HideAll
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-VerbosityLevel

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

Type:VerbosityLevelType
Accepted values:AllMessages, OnlySuccessAndErrorMessages, OnlyErrorMessages
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

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

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

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

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

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

System.Object