Set-CMDriverPackage

  • Ссылка
Модуль:
ConfigurationManager

Изменение пакета драйвера.

Синтаксис

Set-CMDriverPackage
   [-CopyToPackageShareOnDistributionPoint <Boolean>]
   [-CustomPackageShareName <String>]
   [-Description <String>]
   [-DisconnectUserFromDistributionPoint <Boolean>]
   [-DisconnectUserFromDistributionPointMins <UInt32>]
   [-DisconnectUserFromDistributionPointRetryCount <UInt32>]
   [-DistributionPointUpdateSchedule <IResultObject>]
   [-DriverManufacturer <String>]
   [-DriverModel <String>]
   [-DriverPackageSource <String>]
   -InputObject <IResultObject>
   [-MulticastAllow <Boolean>]
   [-MulticastEncrypt <Boolean>]
   [-MulticastTransferOnly <Boolean>]
   [-NewName <String>]
   [-PassThru]
   [-PrestageBehavior <PrestageBehavior>]
   [-Priority <Priority>]
   [-SendToPreferredDistributionPoint <Boolean>]
   [-Version <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMDriverPackage
   [-CopyToPackageShareOnDistributionPoint <Boolean>]
   [-CustomPackageShareName <String>]
   [-Description <String>]
   [-DisconnectUserFromDistributionPoint <Boolean>]
   [-DisconnectUserFromDistributionPointMins <UInt32>]
   [-DisconnectUserFromDistributionPointRetryCount <UInt32>]
   [-DistributionPointUpdateSchedule <IResultObject>]
   [-DriverManufacturer <String>]
   [-DriverModel <String>]
   [-DriverPackageSource <String>]
   -Id <String>
   [-MulticastAllow <Boolean>]
   [-MulticastEncrypt <Boolean>]
   [-MulticastTransferOnly <Boolean>]
   [-NewName <String>]
   [-PassThru]
   [-PrestageBehavior <PrestageBehavior>]
   [-Priority <Priority>]
   [-SendToPreferredDistributionPoint <Boolean>]
   [-Version <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMDriverPackage
   [-CopyToPackageShareOnDistributionPoint <Boolean>]
   [-CustomPackageShareName <String>]
   [-Description <String>]
   [-DisconnectUserFromDistributionPoint <Boolean>]
   [-DisconnectUserFromDistributionPointMins <UInt32>]
   [-DisconnectUserFromDistributionPointRetryCount <UInt32>]
   [-DistributionPointUpdateSchedule <IResultObject>]
   [-DriverManufacturer <String>]
   [-DriverModel <String>]
   [-DriverPackageSource <String>]
   [-MulticastAllow <Boolean>]
   [-MulticastEncrypt <Boolean>]
   [-MulticastTransferOnly <Boolean>]
   -Name <String>
   [-NewName <String>]
   [-PassThru]
   [-PrestageBehavior <PrestageBehavior>]
   [-Priority <Priority>]
   [-SendToPreferredDistributionPoint <Boolean>]
   [-Version <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Описание

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

Дополнительные сведения см. в разделе Управление драйверами в Configuration Manager.

Примечание.

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

Примеры

Пример 1. Настройка производителя и модели пакета драйвера

Эта команда настраивает изготовителя и модель пакета драйвера с идентификатором XYZ00091.

Set-CMDriverPackage -PackageId "XYZ00091" -DriverManufacturer "Microsoft" -DriverModel "Surface 2"

Параметры

-Confirm

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

Тип:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-CopyToPackageShareOnDistributionPoint

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

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

Тип:Boolean
Aliases:CopyToPackageShareOnDistributionPoints
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-CustomPackageShareName

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

Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Description

Укажите необязательное описание пакета драйвера для его идентификации.

Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-DisableWildcardHandling

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

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-DisconnectUserFromDistributionPoint

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

Тип:Boolean
Aliases:DisconnectUsersFromDistributionPoints
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-DisconnectUserFromDistributionPointMins

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

Тип:UInt32
Aliases:DisconnectUsersFromDistributionPointsMinutes
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-DisconnectUserFromDistributionPointRetryCount

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

Тип:UInt32
Aliases:DisconnectUsersFromDistributionPointsRetries
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-DistributionPointUpdateSchedule

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

Тип:IResultObject
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-DriverManufacturer

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

Используйте его с параметром DriverModel . Их можно использовать для управления каталогом драйверов и предварительного кэширования последовательности задач. Дополнительные сведения см. в разделе Настройка содержимого перед кэшем для последовательностей задач.

Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-DriverModel

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

Используйте его с параметром DriverManufacturer . Их можно использовать для управления каталогом драйверов и предварительного кэширования последовательности задач. Дополнительные сведения см. в разделе Настройка содержимого перед кэшем для последовательностей задач.

Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-DriverPackageSource

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

При создании пакета драйвера исходное расположение пакета должно указывать на пустую сетевую папку, которая не используется другим пакетом драйверов. Поставщик SMS должен иметь разрешения на полный доступ к такому расположению.

При добавлении драйверов устройств в пакет драйверов Configuration Manager копирует его в этот путь. В пакет драйверов можно добавить только импортированные драйверы устройств, включенные в каталоге драйверов.

Тип:String
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-CMDriverPackage .

Тип:IResultObject
Position:Named
Default value:None
Обязательно:True
Принять входные данные конвейера:True
Принять подстановочные знаки: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

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

Тип: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

-PrestageBehavior

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

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

Дополнительные сведения см. в разделе Использование предварительно подготовленного содержимого.

Тип:PrestageBehavior
Допустимые значения:ManualCopy, DownloadDelta, OnDemand
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Priority

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

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

Тип:Priority
Допустимые значения:High, Medium, Low
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-SendToPreferredDistributionPoint

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

Тип:Boolean
Aliases:SendToPreferredDistributionPoints
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Version

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

Тип: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