Import-CMDriver

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

Sintaxis

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 varios controladores de dispositivo en el catálogo de controladores de Configuration Manager. Al importar controladores de dispositivo en el catálogo, puede agregar los controladores de dispositivo a los paquetes de controladores o a los 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 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: Importación de 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 \\Server1\Driverred .

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

Ejemplo 2: Importación de un controlador de dispositivo por nombre

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

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

Parámetros

-AdministrativeCategory

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

Asigne los controladores de dispositivo a una categoría con fines de filtrado, como escritorios o cuadernos.

Tipo:IResultObject[]
Alias:AdministrativeCategories
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín: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.

Tipo:String[]
Alias:AdministrativeCategoryNames
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín: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.

Agregue solo los controladores que Windows PE (WinPE) necesita 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 los controladores de red y almacenamiento que no están incluidos 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.

Tipo:IResultObject[]
Alias:BootImagePackages
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

-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

-DriverPackage

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

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

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

-EnableAndAllowInstall

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

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

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

-ImportDuplicateDriverOption

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

  • AppendCategory: importe el controlador y anexe una nueva categoría a las categorías - KeepExistingCategoryexistentes: importe el controlador y mantenga las categorías existentes.
  • NotImport: no importe el controlador
  • OverwriteCategory: importe el controlador y sobrescriba las categorías existentes.
Tipo:ImportDuplicateDriverOption
Valores aceptados:NotImport, AppendCategory, KeepExistingCategory, OverwriteCategory
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-ImportFolder

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

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

-Path

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

Tipo:String
Alias:FileName, FilePath, ImportFilePath, Location, UncFileLocation
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-SupportedPlatform

Especifique un objeto de plataforma compatible al que el controlador de dispositivo es aplicable y se puede ejecutar. Para obtener este objeto, use el cmdlet Get-CMSupportedPlatform .

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

-SupportedPlatformName

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

Tipo:String[]
Alias:SupportedPlatformNames
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

-UpdateDriverPackageDistributionPoint

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

Tipo:Boolean
Alias:UpdateDistributionPointsforDriverPackage
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

None

Salidas

IResultObject