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>]Описание
Используйте этот командлет для изменения параметров пакета. Дополнительные сведения см. в разделе Пакеты и программы в Configuration Manager.
Примечание.
Запустите командлеты Configuration Manager с диска сайта Configuration Manager, например PS XYZ:\>. Дополнительные сведения см. в статье Начало работы.
Примеры
Пример 1. Переименование пакета и добавление описания
Эта команда переименовывает пакет с идентификатором ST120001в ScriptsPackage02 и добавляет описание.
Set-CMPackage -Id "ST120001" -NewName "ScriptsPackage02" -Description "This package deploys scripts that run on a recurring schedule."Пример 2. Изменение пути к источнику пакета
Первая команда получает пакет с идентификатором ST120001 и сохраняет результаты в переменной $Pkg . Вторая команда изменяет исходный путь к пакету.
$pkg = Get-CMPackage -Id "ST120001"
Set-CMPackage -InputObject $pkg -Path "\\sources\cmpkg$\newpkg01"Параметры
-Confirm
Добавьте этот параметр, чтобы запрашивать подтверждение перед выполнением командлета.
| Тип: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | False |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-CopyToPackageShareOnDistributionPoint
Клиенты всегда могут скачать пакет из точки распространения. Если задать для этого параметра значение $true, сайт сделает его доступным через именованный сетевой ресурс в точках распространения. Используйте CustomPackageShareName , чтобы указать пользовательское имя общей папки.
При включении этого параметра в точках распространения требуется больше места. Он применяется ко всем точкам распространения, в которые распространяется этот пакет.
| Тип: | Boolean |
| Aliases: | ShareContent, CopyToPackageShareOnDistributionPoints |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-CustomPackageShareName
Если вы включите CopyToPackageShareOnDistributionPoint, этот параметр можно использовать для настройки имени общей папки. Максимальная длина составляет 127 символов и не может содержать следующие символы: " / [ ] : | < > + = ; , ? *. Можно указать имя общей папки и имя папки, но максимальное значение для каждого из них — 80 символов. Например, ShareName\FolderName.
| Тип: | String |
| Aliases: | ShareName |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-Description
Укажите необязательное описание пакета, чтобы помочь определить его. Можно использовать не более 128 символов.
| Тип: | String |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-DisableWildcardHandling
Этот параметр обрабатывает подстановочные знаки как литеральные символы. Вы не можете объединить его с ForceWildcardHandling.
| Тип: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-DisconnectUserFromDistributionPoint
Этот параметр не рекомендуется. Он задает свойство ForcedDisconnectEnabled пакета драйвера.
| Тип: | Boolean |
| Aliases: | ForceDisconnectEnabled, DisconnectUsersFromDistributionPoints |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-DisconnectUserFromDistributionPointMins
Этот параметр не рекомендуется. Он задает свойство ForcedDisconnectDelay пакета драйвера.
| Тип: | UInt32 |
| Aliases: | ForcedDisconnectDelay, DisconnectUsersFromDistributionPointsMinutes, DisconnectUserFromDistributionPointsMins, DisconnectUserFromDistributionPointsMinutes |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-DisconnectUserFromDistributionPointRetry
Этот параметр не рекомендуется. Он задает свойство ForcedDisconnectNumRetries пакета драйвера.
| Тип: | UInt32 |
| Aliases: | ForceDisconnectNumRetries, DisconnectUsersFromDistributionPointsRetries |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-DistributionPointUpdateSchedule
Используйте этот параметр для обновления точек распространения по расписанию. Чтобы получить объект schedule, используйте командлет New-CMSchedule .
| Тип: | IResultObject |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-EnableBinaryDeltaReplication
Задайте для этого параметра значение $true , чтобы включить двоичную разностную репликацию (BDR). Дополнительные сведения см. в статье Основные понятия управления содержимым в Configuration Manager.
| Тип: | Boolean |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-ForceWildcardHandling
Этот параметр обрабатывает подстановочные знаки и может привести к непредвиденному поведению (не рекомендуется). Его нельзя объединить с DisableWildcardHandling.
| Тип: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-Id
Укажите идентификатор пакета для настройки. Это значение является стандартным идентификатором пакета, например : XYZ00020.
| Тип: | String |
| Aliases: | PackageId |
| Position: | Named |
| Default value: | None |
| Обязательно: | True |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-InputObject
Укажите объект пакета для настройки. Чтобы получить этот объект, используйте командлет Get-CMPackage .
| Тип: | IResultObject |
| Position: | 0 |
| Default value: | None |
| Обязательно: | True |
| Принять входные данные конвейера: | True |
| Принять подстановочные знаки: | False |
-Language
Укажите языковую строку для пакета. Можно использовать не более 32 символов в формате, выбранном для определения версии языка. Для идентификации пакета Configuration Manager использует параметры Язык, Производитель, Имя и Версия . Например, можно использовать версию одного пакета на английском и немецком языках.
| Тип: | String |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-Manufacturer
Укажите имя производителя программного обеспечения. Можно использовать не более 32 символов. Для идентификации пакета Configuration Manager использует параметры Язык, Производитель, Имя и Версия .
| Тип: | String |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-MifFileName
Укажите имя MIF-файла, содержащего состояние пакета. Расширение имени файла должно иметь значение .mif. Используйте MIF-файл состояния для создания подробных отчетов о состоянии. Чтобы создать MIF-файл состояния, приложение должно вызвать функцию InstallStatusMIF. Дополнительные сведения см. в разделе Функции MIF состояния.
Если этот параметр задан, то при запуске развертывания клиент Configuration Manager ищет в %TEMP% каталоге или %windir% каталоге указанный MIF-файл состояния установки. Состояние установки указывает, успешно ли запущена программа.
Если клиент не находит файл, он выполняет поиск всех MIF-файлов в этих каталогах. Он сравнивает значения, указанные для MifName, MifPublisher и MifVersion без учета регистра, со значениями, указанными в файле MIF. Если клиент находит совпадение, он использует состояние, указанное MIF-файлом в качестве состояния установки программы. Если не удается найти совпадение или не указать MifFileName, клиент использует код выхода программы, чтобы задать состояние установки программы. Код выхода с нулевым значением указывает, что программа успешно запущена. Любые другие значения указывают на коды ошибок, относящихся к конкретному приложению.
| Тип: | String |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-MifName
Укажите имя пакета для сопоставления MIF( не более 50 символов). Дополнительные сведения см. в параметре MifFileName .
| Тип: | String |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-MifPublisher
Укажите издателя программного обеспечения пакета для сопоставления MIF(до 32 символов). Дополнительные сведения см. в параметре MifFileName .
| Тип: | String |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-MifVersion
Укажите номер версии пакета для сопоставления MIF( не более 32 символов). Дополнительные сведения см. в параметре MifFileName .
| Тип: | String |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-MulticastAllow
Задайте для этого параметра значение $true , чтобы разрешить передачу этого пакета с помощью многоадресной рассылки. Дополнительные сведения см. в статье Использование многоадресной рассылки для развертывания Windows по сети с помощью Configuration Manager.
| Тип: | Boolean |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-MulticastEncrypt
Если включить multicastAllow, задайте для этого параметра значение $true для шифрования пакетов многоадресной рассылки.
| Тип: | Boolean |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-MulticastTransferOnly
Если вы включили MulticastAllow, задайте для этого параметра значение $true только для передачи этого пакета драйвера через многоадресную рассылку.
| Тип: | Boolean |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-Name
Укажите имя пакета. Можно использовать не более 250 символов. Для идентификации пакета Configuration Manager использует параметры Язык, Производитель, Имя и Версия .
| Тип: | String |
| Position: | Named |
| Default value: | None |
| Обязательно: | True |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-NewName
Используйте этот параметр для переименования пакета.
| Тип: | String |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-PassThru
Добавьте этот параметр, чтобы вернуть объект, представляющий элемент, с которым вы работаете. По умолчанию этот командлет не может создавать выходные данные.
| Тип: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-Path
Если пакет содержит исходные файлы, укажите расположение файлов. Можно указать полный локальный путь на сервере сайта или сетевой путь. Убедитесь, что в этом расположении содержатся все файлы и подкаталоги, необходимые для запуска программы, включая все скрипты.
| Тип: | String |
| Aliases: | PackageSourcePath |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-PersistContentInCache
Если вы не хотите, чтобы содержимое этого пакета стареет из кэша клиента, чтобы освободить место для другого содержимого, задайте для этого параметра значение $true , чтобы сохранить его в кэше клиента.
| Тип: | Boolean |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-PrestageBehavior
Укажите поведение при включении точки распространения для предварительно подготовленного содержимого:
-
ManualCopy: вручную скопируйте содержимое этого пакета в точку распространения. -
DownloadDelta: скачивание только изменений содержимого в точку распространения -
OnDemand: автоматическое скачивание содержимого при назначении пакетов точкам распространения
Дополнительные сведения см. в разделе Использование предварительно подготовленного содержимого.
| Тип: | PrestageBehavior |
| Допустимые значения: | ManualCopy, DownloadDelta, OnDemand |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-Priority
Укажите порядок, в котором сайт отправляет содержимое другим сайтам и точкам распространения на этом сайте.
Сайт отправляет содержимое с высоким приоритетом перед пакетами с обычным или низким приоритетом. Пакеты с равным приоритетом отправляются в том порядке, в котором они создаются.
| Тип: | Priorities |
| Aliases: | DistributionPriority |
| Допустимые значения: | High, Normal, Low |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-SendToPreferredDistributionPoint
Если вы хотите включить распространение содержимого по запросу в предпочтительные точки распространения, задайте для этого параметра значение $true. Если этот параметр включен, если клиент запрашивает содержимое для пакета и содержимое недоступно ни в каких точках распространения, точка управления распространяет содержимое. Дополнительные сведения см. в разделе Распространение содержимого по запросу.
| Тип: | Boolean |
| Aliases: | SendToPreferredDistributionPoints |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-Version
Укажите номер версии программного обеспечения. Максимальная длина этой строки — 32 символа. Для идентификации пакета Configuration Manager использует параметры Язык, Производитель, Имя и Версия .
| Тип: | String |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-WhatIf
Показывает, что произойдет при запуске этого командлета. Командлет не выполняется.
| Тип: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | False |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
Входные данные
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
Выходные данные
System.Object