Set-CMDriver

Módulo:

ConfigurationManager

Cambia la configuración de un controlador de dispositivo.

Syntax

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 Configuration Manager, por ejemploPS 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 .

Type:	IResultObject[]
Aliases:	AddAdministrativeCategories
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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 .

Type:	IResultObject[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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 .

Type:	IResultObject[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-AddSupportedPlatformName

{{ Fill AddSupportedPlatformName Description }}

Type:	String[]
Aliases:	AddSupportedPlatformNames
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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 .

Type:	IResultObject[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ClearAdministrativeCategory

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

Type:	SwitchParameter
Aliases:	ClearAdministrativeCategories
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ClearSupportedPlatformName

{{ Rellenar ClearSupportedPlatformName Description }}

Type:	SwitchParameter
Aliases:	ClearSupportedPlatformNames
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Confirm

Solicitará confirmación antes de ejecutar el cmdlet.

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Description

Especifica una descripción para el controlador de dispositivo.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DisableWildcardHandling

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-EnableAndAllowInstall

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

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ForceWildcardHandling

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Id

Especifica el identificador de un controlador de dispositivo.

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-InputObject

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

Type:	IResultObject
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-Name

Especifica el nombre de un controlador de dispositivo.

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-NewName

Especifica un nuevo nombre para el controlador de dispositivo.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-PassThru

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	IResultObject[]
Aliases:	RemoveAdministrativeCategories
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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 .

Type:	IResultObject[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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 .

Type:	IResultObject[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-RemoveSupportedPlatformName

{{ Fill RemoveSupportedPlatformName Description }}

Type:	String[]
Aliases:	RemoveSupportedPlatformNames
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-RunOnAnyPlatform

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-SupportedPlatformName

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

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-UpdateBootImageDistributionPoint

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

Type:	Boolean
Aliases:	UpdateDistributionPointsForBootImagePackage, UpdateBootImageDistributionPoints
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-UpdateDriverDistributionPoint

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

Type:	Boolean
Aliases:	UpdateDistributionPointsForDriverPackage, UpdateDriverDistributionPoints
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-WhatIf

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

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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