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\Driver
red .
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\Driver
de 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- KeepExistingCategory
existentes: 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