Set-CMPackage
Изменение пакета.
Синтаксис
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