Import-CMDriver

Importe un controlador de dispositivo en el catálogo de controladores.

Syntax

Import-CMDriver
      [-AdministrativeCategory <IResultObject[]>]
      [-AdministrativeCategoryName <String[]>]
      [-BootImagePackage <IResultObject[]>]
      [-DriverPackage <IResultObject[]>]
      [-EnableAndAllowInstall <Boolean>]
      [-ImportDuplicateDriverOption <ImportDuplicateDriverOption>]
      [-ImportFolder]
      -Path <String>
      [-SupportedPlatform <IResultObject[]>]
      [-SupportedPlatformName <String[]>]
      [-UpdateBootImageDistributionPoint <Boolean>]
      [-UpdateDriverPackageDistributionPoint <Boolean>]
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

El cmdlet Import-CMDriver importa uno o más controladores de dispositivo en el catálogo de controladores de Configuration Manager. Al importar controladores de dispositivo en el catálogo, puedes agregar los controladores de dispositivo a paquetes de controladores o a paquetes de imagen de arranque.

Como parte del proceso de importación del controlador de dispositivo, Configuration Manager lee la siguiente información asociada al dispositivo:

  • Proveedor
  • Clase
  • Versión
  • Firma
  • Hardware compatible
  • Plataforma compatible

De forma predeterminada, el controlador recibe el nombre del primer dispositivo de hardware que admite. Para cambiar el nombre del controlador de dispositivo, use el parámetro -NewName del cmdlet Set-CMDriver. La lista de plataformas admitidas se basa en la información del archivo INF del controlador. Dado que la precisión de esta información puede variar, compruebe manualmente que el controlador de dispositivo es compatible después de importarlo al catálogo de controladores.

Nota

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

Ejemplos

Ejemplo 1: Importar todos los controladores de dispositivo en una ruta de acceso

Este comando importa todos los controladores de dispositivo ubicados en la ruta de acceso de red \\Server1\Driver .

Import-CMDriver -Path "\\Server1\Driver" -ImportFolder

Ejemplo 2: Importar un controlador de dispositivo por su nombre

Este comando importa el controlador denominado driver.inf de la ruta de acceso de red \\Server1\Driver .

Import-CMDriver -Path "\\Server1\Driver\driver.inf"

Parámetros

- Confirm

Solicitará confirmación antes de ejecutar el cmdlet.

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

-AdministrativeCategory

Especifique una matriz de objetos de categoría. Para obtener este objeto, use el cmdlet Get-CMCategory.

Asigna los controladores de dispositivo a una categoría con fines de filtrado, como escritorios o blocs de notas.

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

-AdministrativeCategoryName

En lugar de obtener y especificar un objeto para una categoría con el parámetro AdministrativeCategory, use este parámetro para especificar simplemente el nombre de una categoría. También puede usar una matriz de nombres de categoría.

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

-BootImagePackage

Especifique una matriz de objetos de imagen de arranque. Para obtener este objeto, use el cmdlet Get-CMBootImage.

Use este parámetro para agregar los controladores importados a las imágenes de arranque especificadas.

Solo agregue controladores que Windows PE (WinPE) requiere para arrancar:

  • Asegúrese de que los controladores que agregue a la imagen de arranque coincidan con la arquitectura de la imagen de arranque.

  • WinPE ya viene con muchos controladores integrados. Agregue solo controladores de red y almacenamiento que no se incluyan en WinPE.

  • Agregue solo controladores de red y almacenamiento a la imagen de arranque, a menos que haya requisitos para otros controladores en WinPE.

  • Es mejor usar controladores que tengan una firma digital válida.

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

-DriverPackage

Especifique una matriz de objetos de paquete de controladores. Para obtener este objeto, use el cmdlet Get-CMDriverPackage.

Use este parámetro para agregar los controladores importados a los paquetes de controladores especificados.

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

-EnableAndAllowInstall

Habilite el controlador y permita que los clientes lo instalen durante el paso de secuencia de tareas Aplicar automáticamente el controlador.

Los controladores agregados al paquete de controladores no se ven afectados.

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

-ImportDuplicateDriverOption

Especifica cómo Configuration Manager administra los controladores de dispositivo duplicados.

  • AppendCategory: Importar el controlador y anexar una nueva categoría a las categorías existentes - KeepExistingCategory : Importar el controlador y mantener las categorías existentes
  • NotImport: No importar el controlador
  • OverwriteCategory: importe el controlador y sobrescriba las categorías existentes
Type:ImportDuplicateDriverOption
Accepted values:NotImport, AppendCategory, KeepExistingCategory, OverwriteCategory
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-ImportFolder

Agregue este parámetro para importar todos los controladores de dispositivo en la carpeta de destino.

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

-Path

Especifique una ruta de acceso a los archivos de controlador que se importarán.

Type:String
Aliases:FileName, FilePath, ImportFilePath, Location, UncFileLocation
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-SupportedPlatform

Especifique un objeto de plataforma compatible al que el controlador de dispositivo sea aplicable y pueda ejecutarse. Para obtener este objeto, use el cmdlet Get-CMSupportedPlatform.

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

-SupportedPlatformName

Especifica una matriz de nombre de plataformas compatibles en la que se puede ejecutar el controlador de dispositivo. Por ejemplo, "All Windows 10 (64-bit)".

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

-UpdateDriverPackageDistributionPoint

Si usa el parámetro -DriverPackage, establezca este parámetro en para actualizar el paquete $true de controladores en los puntos de distribución asignados.

Type:Boolean
Aliases:UpdateDistributionPointsforDriverPackage
Position:Named
Default value:None
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
Accept pipeline input:False
Accept wildcard characters:False

Entradas

Ninguno

Salidas

IResultObject