Set-CMDriver

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

Изменяет параметры драйвера устройства.

Синтаксис

Set-CMDriver
   [-AddAdministrativeCategory <IResultObject[]>]
   [-AddBootImagePackage <IResultObject[]>]
   [-AddDriverPackage <IResultObject[]>]
   [-AddSupportedPlatformName <String[]>]
   [-AdministrativeCategory <IResultObject[]>]
   [-ClearAdministrativeCategory]
   [-ClearSupportedPlatformName]
   [-Description <String>]
   [-DriverSource <String>]
   [-EnableAndAllowInstall <Boolean>]
   -InputObject <IResultObject>
   [-NewName <String>]
   [-PassThru]
   [-RemoveAdministrativeCategory <IResultObject[]>]
   [-RemoveBootImagePackage <IResultObject[]>]
   [-RemoveDriverPackage <IResultObject[]>]
   [-RemoveSupportedPlatformName <String[]>]
   [-RunOnAnyPlatform]
   [-SupportedPlatformName <String[]>]
   [-UpdateBootImageDistributionPoint <Boolean>]
   [-UpdateDriverDistributionPoint <Boolean>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMDriver
   [-AddAdministrativeCategory <IResultObject[]>]
   [-AddBootImagePackage <IResultObject[]>]
   [-AddDriverPackage <IResultObject[]>]
   [-AddSupportedPlatformName <String[]>]
   [-AdministrativeCategory <IResultObject[]>]
   [-ClearAdministrativeCategory]
   [-ClearSupportedPlatformName]
   [-Description <String>]
   [-DriverSource <String>]
   [-EnableAndAllowInstall <Boolean>]
   -Id <String>
   [-NewName <String>]
   [-PassThru]
   [-RemoveAdministrativeCategory <IResultObject[]>]
   [-RemoveBootImagePackage <IResultObject[]>]
   [-RemoveDriverPackage <IResultObject[]>]
   [-RemoveSupportedPlatformName <String[]>]
   [-RunOnAnyPlatform]
   [-SupportedPlatformName <String[]>]
   [-UpdateBootImageDistributionPoint <Boolean>]
   [-UpdateDriverDistributionPoint <Boolean>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMDriver
   [-AddAdministrativeCategory <IResultObject[]>]
   [-AddBootImagePackage <IResultObject[]>]
   [-AddDriverPackage <IResultObject[]>]
   [-AddSupportedPlatformName <String[]>]
   [-AdministrativeCategory <IResultObject[]>]
   [-ClearAdministrativeCategory]
   [-ClearSupportedPlatformName]
   [-Description <String>]
   [-DriverSource <String>]
   [-EnableAndAllowInstall <Boolean>]
   -Name <String>
   [-NewName <String>]
   [-PassThru]
   [-RemoveAdministrativeCategory <IResultObject[]>]
   [-RemoveBootImagePackage <IResultObject[]>]
   [-RemoveDriverPackage <IResultObject[]>]
   [-RemoveSupportedPlatformName <String[]>]
   [-RunOnAnyPlatform]
   [-SupportedPlatformName <String[]>]
   [-UpdateBootImageDistributionPoint <Boolean>]
   [-UpdateDriverDistributionPoint <Boolean>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Описание

Командлет Set-CMDriver изменяет параметры драйвера устройства в каталоге драйверов.

Примечание.

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

Примеры

Пример 1. Изменение драйвера

PS XYZ:\> $Driver = Get-CMDriver -Name "cdrom.sys"
PS XYZ:\> Set-CMDriver -InputObject $Driver -NewName "testDriver" -Description "Test configuration" -EnableAndAllowInstall $True -RunOnAnyPlatform $True

Первая команда получает драйвер устройства с именем cdrom.sys с помощью командлета Get-CMDriver . Команда сохраняет этот объект в переменной $Driver.

Вторая команда переименовывает драйвер и добавляет описание. Команда задает значения для параметров EnableAndAllowInstall и RunOnAnyPlatform .

Пример 2. Изменение драйвера с помощью конвейера

PS XYZ:\> Get-CMDriver -Name "cdrom.sys" | Set-CMDriver -NewName testDriver -Description description -EnableAndAllowInstall $True -RunOnAnyPlatform $True

Эта команда получает драйвер с именем cdrom.sys, а затем передает его в текущий командлет с помощью оператора конвейера. Текущий командлет переименовывает драйвер и добавляет описание. Команда задает значения для EnableAndAllowInstall и RunOnAnyPlatform.

Параметры

-AddAdministrativeCategory

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

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

-AddBootImagePackage

Задает массив объектов образа загрузки. Используйте этот параметр, чтобы указать загрузочные образы, которые могут устанавливать драйверы устройств. Чтобы получить объект образа загрузки, используйте командлет Get-CMBootImage .

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

-AddDriverPackage

Задает массив объектов пакета драйверов. Используйте этот параметр, чтобы указать пакеты драйверов, которые Configuration Manager использует для распространения драйверов устройств. Чтобы получить объект пакета драйвера, используйте командлет Get-CMDriverPackage .

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

-AddSupportedPlatformName

{{ Fill AddSupportedPlatformName Description }}

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

-AdministrativeCategory

Задает массив административных категорий. Назначьте драйверы устройств административной категории для целей фильтрации, таких как категории "Рабочие столы" или "Записные книжки".

Чтобы получить объект административной категории, используйте командлет Get-CMCategory .

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

-ClearAdministrativeCategory

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

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

-ClearSupportedPlatformName

{{ Fill ClearSupportedPlatformName Description }}

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

-Confirm

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

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

-Description

Указывает описание драйвера устройства.

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

-DisableWildcardHandling

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

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

-DriverSource

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

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

-EnableAndAllowInstall

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

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

-ForceWildcardHandling

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

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

-Id

Указывает идентификатор драйвера устройства.

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

-InputObject

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

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

-RemoveAdministrativeCategory

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

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

-RemoveBootImagePackage

Задает массив объектов образа загрузки. Используйте этот параметр для удаления загрузочных образов, которые могут установить драйвер устройства. Чтобы получить объект образа загрузки, используйте командлет Get-CMBootImage .

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

-RemoveDriverPackage

Задает массив объектов пакета драйверов. Этот параметр используется для удаления пакетов драйверов, которые Configuration Manager использует для распространения драйверов устройств. Чтобы получить объект пакета драйвера, используйте командлет Get-CMDriverPackage .

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

-RemoveSupportedPlatformName

{{ Fill RemoveSupportedPlatformName Description }}

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

-RunOnAnyPlatform

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

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

-SupportedPlatformName

Задает массив имен платформ, на которых может выполняться драйвер устройства.

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

-UpdateBootImageDistributionPoint

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

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

-UpdateDriverDistributionPoint

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

Тип:Boolean
Aliases:UpdateDistributionPointsForDriverPackage, UpdateDriverDistributionPoints
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