Set-CMDriver

Módulo:

ConfigurationManager

Cambia la configuración de un controlador de dispositivo.

Sintaxis

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>]

Description

El cmdlet Set-CMDriver cambia la configuración de un controlador de dispositivo en el catálogo de controladores.

Nota:

Ejecute cmdlets de Configuration Manager desde la unidad de sitio de Configuration Manager, por ejemplo PS XYZ:\>. Para obtener más información, consulte Introducción.

Ejemplos

Ejemplo 1: Modificación de un controlador

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

El primer comando obtiene un controlador de dispositivo denominado cdrom.sys mediante el cmdlet Get-CMDriver . El comando almacena ese objeto en la variable $Driver.

El segundo comando cambia el nombre del controlador y agrega una descripción. El comando especifica valores para los parámetros EnableAndAllowInstall y RunOnAnyPlatform .

Ejemplo 2: Modificación de un controlador mediante la canalización

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

Este comando obtiene un controlador denominado cdrom.sys y, a continuación, lo pasa al cmdlet actual mediante el operador de canalización. El cmdlet actual cambia el nombre del controlador y agrega una descripción. El comando especifica valores para EnableAndAllowInstall y RunOnAnyPlatform.

Parámetros

-AddAdministrativeCategory

Especifica una matriz de objetos de categoría administrativa que este cmdlet agrega a un controlador. Para obtener un objeto de categoría administrativa, use el cmdlet Get-CMCategory .

Tipo:	IResultObject[]
Alias:	AddAdministrativeCategories
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-AddBootImagePackage

Especifica una matriz de objetos de imagen de arranque. Use este parámetro para especificar las imágenes de arranque que pueden instalar los controladores de dispositivo. Para obtener un objeto de imagen de arranque, use el cmdlet Get-CMBootImage .

Tipo:	IResultObject[]
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-AddDriverPackage

Especifica una matriz de objetos de paquete de controlador. Use este parámetro para especificar los paquetes de controladores que Configuration Manager usa para distribuir los controladores de dispositivo. Para obtener un objeto de paquete de controlador, use el cmdlet Get-CMDriverPackage .

Tipo:	IResultObject[]
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-AddSupportedPlatformName

{{ Fill AddSupportedPlatformName Description }}

Tipo:	String[]
Alias:	AddSupportedPlatformNames
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-AdministrativeCategory

Especifica una matriz de categorías administrativas. Asigne los controladores de dispositivo a una categoría administrativa con fines de filtrado, como las categorías Escritorios o Cuadernos.

Para obtener un objeto de categoría administrativa, use el cmdlet Get-CMCategory .

Tipo:	IResultObject[]
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-ClearAdministrativeCategory

Indica que este cmdlet quita todos los objetos de categoría administrativa del controlador.

Tipo:	SwitchParameter
Alias:	ClearAdministrativeCategories
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-ClearSupportedPlatformName

{{ Rellenar ClearSupportedPlatformName Description }}

Tipo:	SwitchParameter
Alias:	ClearSupportedPlatformNames
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-Confirm

Solicitará confirmación antes de ejecutar el cmdlet.

Tipo:	SwitchParameter
Alias:	cf
Posición:	Named
Valor predeterminado:	False
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-Description

Especifica una descripción para el controlador de dispositivo.

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-DisableWildcardHandling

Este parámetro trata los caracteres comodín como valores de caracteres literales. No se puede combinar con ForceWildcardHandling.

Tipo:	SwitchParameter
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-DriverSource

Especifica la ubicación de origen del paquete de controladores. Al crear un paquete de controladores, la ubicación de origen del paquete debe apuntar a un recurso compartido de red vacío que no usa otro paquete de controladores.

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-EnableAndAllowInstall

Indica si Configuration Manager habilita los controladores y permite que los equipos instalen los controladores.

Tipo:	Boolean
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-ForceWildcardHandling

Este parámetro procesa caracteres comodín y puede provocar un comportamiento inesperado (no recomendado). No se puede combinar con DisableWildcardHandling.

Tipo:	SwitchParameter
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-Id

Especifica el identificador de un controlador de dispositivo.

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-InputObject

Especifica un objeto de controlador. Para obtener un objeto de controlador, use el cmdlet Get-CMDriver .

Tipo:	IResultObject
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	True
Aceptar caracteres comodín:	False

-Name

Especifica el nombre de un controlador de dispositivo.

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-NewName

Especifica un nuevo nombre para el controlador de dispositivo.

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-PassThru

Devuelve un objeto que representa el controlador. De forma predeterminada, este cmdlet no genera resultados.

Tipo:	SwitchParameter
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-RemoveAdministrativeCategory

Especifica una matriz de objetos de categoría administrativa que este cmdlet quita de un controlador. Para obtener un objeto de categoría administrativa, use Get-CMCategory.

Tipo:	IResultObject[]
Alias:	RemoveAdministrativeCategories
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-RemoveBootImagePackage

Especifica una matriz de objetos de imagen de arranque. Use este parámetro para quitar las imágenes de arranque que pueden instalar el controlador de dispositivo. Para obtener un objeto de imagen de arranque, use el cmdlet Get-CMBootImage .

Tipo:	IResultObject[]
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-RemoveDriverPackage

Especifica una matriz de objetos de paquete de controlador. Use este parámetro para quitar los paquetes de controladores que Configuration Manager usa para distribuir los controladores de dispositivo. Para obtener un objeto de paquete de controlador, use el cmdlet Get-CMDriverPackage .

Tipo:	IResultObject[]
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-RemoveSupportedPlatformName

{{ Fill RemoveSupportedPlatformName Description }}

Tipo:	String[]
Alias:	RemoveSupportedPlatformNames
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-RunOnAnyPlatform

Indica que el controlador del dispositivo se puede ejecutar en todas las plataformas.

Tipo:	SwitchParameter
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-SupportedPlatformName

Especifica una matriz de nombres de plataformas en las que se puede ejecutar el controlador de dispositivo.

Tipo:	String[]
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-UpdateBootImageDistributionPoint

Indica si Configuration Manager actualiza las imágenes de arranque en sus puntos de distribución para agregar los nuevos controladores.

Tipo:	Boolean
Alias:	UpdateDistributionPointsForBootImagePackage, UpdateBootImageDistributionPoints
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-UpdateDriverDistributionPoint

Indica que Configuration Manager actualiza los puntos de distribución cuando se agrega el controlador de dispositivo al paquete de controladores.

Tipo:	Boolean
Alias:	UpdateDistributionPointsForDriverPackage, UpdateDriverDistributionPoints
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-WhatIf

Muestra lo que ocurriría si se ejecuta el cmdlet. El cmdlet no se ejecuta.

Tipo:	SwitchParameter
Alias:	wi
Posición:	Named
Valor predeterminado:	False
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

Entradas

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Salidas

System.Object

Vínculos relacionados

• Disable-CMDriver
• Enable-CMDriver
• Get-CMDriver
• Import-CMDriver
• Remove-CMDriver
• Get-CMCategory
• Get-CMBootImage
• Get-CMDriverPackage