Set-CMPackage

Модуль:

ConfigurationManager

Изменение пакета.

Синтаксис

Set-CMPackage
   [-CopyToPackageShareOnDistributionPoint <Boolean>]
   [-CustomPackageShareName <String>]
   [-Description <String>]
   [-DisconnectUserFromDistributionPoint <Boolean>]
   [-DisconnectUserFromDistributionPointMins <UInt32>]
   [-DisconnectUserFromDistributionPointRetry <UInt32>]
   [-DistributionPointUpdateSchedule <IResultObject>]
   [-EnableBinaryDeltaReplication <Boolean>]
   [-InputObject] <IResultObject>
   [-Language <String>]
   [-Manufacturer <String>]
   [-MifFileName <String>]
   [-MifName <String>]
   [-MifPublisher <String>]
   [-MifVersion <String>]
   [-MulticastAllow <Boolean>]
   [-MulticastEncrypt <Boolean>]
   [-MulticastTransferOnly <Boolean>]
   [-NewName <String>]
   [-PassThru]
   [-Path <String>]
   [-PersistContentInCache <Boolean>]
   [-PrestageBehavior <PrestageBehavior>]
   [-Priority <Priorities>]
   [-SendToPreferredDistributionPoint <Boolean>]
   [-Version <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-CMPackage
   [-CopyToPackageShareOnDistributionPoint <Boolean>]
   [-CustomPackageShareName <String>]
   [-Description <String>]
   [-DisconnectUserFromDistributionPoint <Boolean>]
   [-DisconnectUserFromDistributionPointMins <UInt32>]
   [-DisconnectUserFromDistributionPointRetry <UInt32>]
   [-DistributionPointUpdateSchedule <IResultObject>]
   [-EnableBinaryDeltaReplication <Boolean>]
   -Id <String>
   [-Language <String>]
   [-Manufacturer <String>]
   [-MifFileName <String>]
   [-MifName <String>]
   [-MifPublisher <String>]
   [-MifVersion <String>]
   [-MulticastAllow <Boolean>]
   [-MulticastEncrypt <Boolean>]
   [-MulticastTransferOnly <Boolean>]
   [-NewName <String>]
   [-PassThru]
   [-Path <String>]
   [-PersistContentInCache <Boolean>]
   [-PrestageBehavior <PrestageBehavior>]
   [-Priority <Priorities>]
   [-SendToPreferredDistributionPoint <Boolean>]
   [-Version <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-CMPackage
   [-CopyToPackageShareOnDistributionPoint <Boolean>]
   [-CustomPackageShareName <String>]
   [-Description <String>]
   [-DisconnectUserFromDistributionPoint <Boolean>]
   [-DisconnectUserFromDistributionPointMins <UInt32>]
   [-DisconnectUserFromDistributionPointRetry <UInt32>]
   [-DistributionPointUpdateSchedule <IResultObject>]
   [-EnableBinaryDeltaReplication <Boolean>]
   [-Language <String>]
   [-Manufacturer <String>]
   [-MifFileName <String>]
   [-MifName <String>]
   [-MifPublisher <String>]
   [-MifVersion <String>]
   [-MulticastAllow <Boolean>]
   [-MulticastEncrypt <Boolean>]
   [-MulticastTransferOnly <Boolean>]
   -Name <String>
   [-NewName <String>]
   [-PassThru]
   [-Path <String>]
   [-PersistContentInCache <Boolean>]
   [-PrestageBehavior <PrestageBehavior>]
   [-Priority <Priorities>]
   [-SendToPreferredDistributionPoint <Boolean>]
   [-Version <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Описание

Используйте этот комдлет, чтобы изменить параметры пакета. Дополнительные сведения см. в программе Packages and programs in Configuration Manager.

Примечание

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

Примеры

Пример 1. Переименование пакета и добавление описания

Эта команда переименовывает пакет с ID ST120001 в ScriptsPackage02 и добавляет описание.

Set-CMPackage -Id "ST120001" -NewName "ScriptsPackage02" -Description "This package deploys scripts that run on a recurring schedule."

Пример 2. Изменение пути источника пакета

Первая команда получает пакет с ID ST120001и сохраняет результаты в переменной $Pkg. Вторая команда изменяет путь источника пакета.

$pkg = Get-CMPackage -Id "ST120001"
Set-CMPackage -InputObject $pkg -Path "\\sources\cmpkg$\newpkg01"

Параметры

-Confirm

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

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

-CopyToPackageShareOnDistributionPoint

Клиенты всегда могут скачать пакет из точки распространения. Если этот параметр $true, сайт делает его доступным с помощью именной сетевой доли в точках распространения. Используйте CustomPackageShareName для указания настраиваемой фамилии.

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

Type:	Boolean
Aliases:	ShareContent, CopyToPackageShareOnDistributionPoints
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-CustomPackageShareName

Если включить CopyToPackageShareOnDistributionPoint, этот параметр можно использовать для настройки имени share. Максимальная длина — 127 символов и не может включать ни один из следующих символов: " / [ ] : | < > + = ; , ? * . Можно указать имя и имя папки, но максимум для каждого из них — 80 символов. Например, ShareName\FolderName.

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

-Description

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

Type:	String
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

-DisconnectUserFromDistributionPoint

Этот параметр не является предопреставным. Он задает свойство ForcedDisconnectEnabled пакета драйверов.

Type:	Boolean
Aliases:	ForceDisconnectEnabled, DisconnectUsersFromDistributionPoints
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-DisconnectUserFromDistributionPointMins

Этот параметр не является предопреставным. Он задает свойство ForcedDisconnectDelay пакета драйвера.

Type:	UInt32
Aliases:	ForcedDisconnectDelay, DisconnectUsersFromDistributionPointsMinutes, DisconnectUserFromDistributionPointsMins, DisconnectUserFromDistributionPointsMinutes
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-DisconnectUserFromDistributionPointRetry

Этот параметр не является предопреставным. Он задает свойство ForcedDisconnectNumRetries пакета драйверов.

Type:	UInt32
Aliases:	ForceDisconnectNumRetries, DisconnectUsersFromDistributionPointsRetries
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-DistributionPointUpdateSchedule

Используйте этот параметр для обновления точек рассылки по расписанию. Чтобы получить объект расписание, используйте комлет New-CMSchedule.

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

-EnableBinaryDeltaReplication

Установите этот параметр для $true, чтобы включить репликацию двоичных дифференциалов (BDR). Дополнительные сведения см. в материалах Fundamental concepts for content management in Configuration Manager.

Type:	Boolean
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

-Id

Укажите ID пакета для настройки. Это значение является стандартным ID пакета, например: XYZ00020 .

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

-InputObject

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

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

-Language

Укажите строку языка для пакета. Для определения языковой версии можно использовать не более 32 символов в формате. Чтобы определить пакет, диспетчер конфигурации использует параметры Language, Manufacturer, Nameи Version. Например, вы можете иметь английскую версию и немецкую версию одного пакета.

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

-Manufacturer

Укажите имя производителя для программного обеспечения. Можно использовать не более 32 символов. Чтобы определить пакет, диспетчер конфигурации использует параметры Language, Manufacturer, Nameи Version.

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

-MifFileName

Укажите имя файла "Формат сведений об управлении" (MIF), который содержит состояние пакета. Расширение имени файла должно быть .mif . Используйте файл MIF состояния для создания подробных отчетов о состоянии. Чтобы создать файл MIF состояния, приложение должно вызвать функцию InstallStatusMIF. Дополнительные сведения см. в дополнительных сведениях о функциях MIF status.

Если задан этот параметр, когда клиент запускает развертывание, клиент Configuration Manager ищет в каталоге или каталоге файл MIF состояния установки, который вы %TEMP% %windir% указываете. Состояние установки указывает, успешно ли прошла программа.

Если клиент не находит файл, он ищет все файлы MIF в этих каталогах. В нем делается сравнение значений, указанных для MifName, MifPublisherи MifVersion, с значениями, указанными в файле MIF. Если клиент находит совпадение, он использует состояние, указанное файлом MIF в качестве состояния установки для программы. Если он не может найти совпадение или не указать MifFileName, клиент использует код выхода программы, чтобы задать состояние установки для программы. Код выхода ноль указывает, что программа успешно выполнила. Любые другие значения указывают коды ошибок, определенных для приложений.

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

-MifName

Укажите имя пакета для совпадения MIF до 50 символов. Дополнительные сведения см. в параметре MifFileName.

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

-MifPublisher

Укажите издателя программного обеспечения пакета для совпадения MIF до 32 символов. Дополнительные сведения см. в параметре MifFileName.

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

-MifVersion

Укажите номер версии пакета для совпадения MIF до 32 символов. Дополнительные сведения см. в параметре MifFileName.

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

-MulticastAllow

Установите этот параметр $true, чтобы разрешить перенос этого пакета с помощью мультикастов. Дополнительные сведения см. в см. в Windows для развертывания Windows с помощью диспетчера конфигурации.

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

-MulticastEncrypt

Если вы включаете MulticastAllow, установите этот параметр $true для шифрования пакетов многофастовки.

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

-MulticastTransferOnly

Если вы включаете MulticastAllow, установите этот параметр $true только для передачи этого пакета драйвера с помощью многокастной передачи. ****

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

-Name

Укажите имя пакета. Можно использовать не более 250 символов. Чтобы определить пакет, диспетчер конфигурации использует параметры Language, Manufacturer, Nameи Version.

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

-NewName

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

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

-Path

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

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

-PersistContentInCache

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

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

-PrestageBehavior

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

• ManualCopy: Вручную скопируйте содержимое в этом пакете в точку распространения
• DownloadDelta: Скачайте только изменения контента в точку распространения
• OnDemand: Автоматически скачивать контент, когда пакеты назначены точкам рассылки

Дополнительные сведения см. в материалах Use prestaged content.

Type:	PrestageBehavior
Accepted values:	ManualCopy, DownloadDelta, OnDemand
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-Priority

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

Сайт отправляет высокооритетный контент перед пакетами с нормальным или низким приоритетом. Пакеты с равным приоритетом отправляются в том порядке, в котором они создаются.

Type:	Priorities
Aliases:	DistributionPriority
Accepted values:	High, Normal, Low
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-SendToPreferredDistributionPoint

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

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

-Version

Укажите номер версии для программного обеспечения. Максимальная длина этой строки — 32 символа. Чтобы определить пакет, диспетчер конфигурации использует параметры Language, Manufacturer, Nameи Version.

Type:	String
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

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

• Export-CMPackage
• Get-CMPackage
• Import-CMPackage
• New-CMPackage
• Remove-CMPackage
• Пакеты и программы в Configuration Manager