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 existentesNotImport
: No importar el controladorOverwriteCategory
: 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