Share via

Import-CMDriver

  • Referência
Módulo:
ConfigurationManager

Importe um driver de dispositivo para o catálogo de driver.

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

O cmdlet Import-CMDriver importa um ou mais drivers de dispositivo para o catálogo de drivers no Configuration Manager. Ao importar drivers de dispositivo para o catálogo, você pode adicionar os drivers de dispositivo a pacotes de driver ou a inicializar pacotes de imagem.

Como parte do processo de importação do driver de dispositivo, o Configuration Manager lê as seguintes informações associadas ao dispositivo:

  • Provedor
  • Classe
  • Versão
  • Assinatura
  • Hardware com suporte
  • Plataforma com suporte

Por padrão, o driver tem o nome do primeiro dispositivo de hardware compatível. Para renomear o driver de dispositivo, use o parâmetro -NewName do cmdlet Set-CMDriver. A lista de plataformas com suporte baseia-se nas informações no arquivo INF do driver. Como a precisão dessas informações pode variar, verifique manualmente se o driver de dispositivo tem suporte depois de importá-lo para o catálogo de driver.

Observação

Execute cmdlets do Configuration Manager na unidade de site do Configuration Manager, por PS XYZ:\> exemplo. Para obter mais informações, consulte getting started.

Exemplos

Exemplo 1: Importar todos os drivers de dispositivo em um caminho

Este comando importa todos os drivers de dispositivo localizados no caminho da rede \\Server1\Driver .

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

Exemplo 2: Importar um driver de dispositivo pelo nome

Este comando importa o driver chamado driver.inf do caminho de rede \\Server1\Driver .

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

Parâmetros

-AdministrativeCategory

Especifique uma matriz de objetos de categoria. Para obter esse objeto, use o cmdlet Get-CMCategory.

Atribua os drivers de dispositivo a uma categoria para fins de filtragem, como Desktops ou Blocos de Anotações.

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

-AdministrativeCategoryName

Em vez de obter e especificar um objeto para uma categoria com o parâmetro AdministrativeCategory, use esse parâmetro para simplesmente especificar o nome de uma categoria. Você também pode usar uma matriz de nomes de categoria.

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

-BootImagePackage

Especifique uma matriz de objetos de imagem de inicialização. Para obter esse objeto, use o cmdlet Get-CMBootImage.

Use este parâmetro para adicionar os drivers importados às imagens de inicialização especificadas.

Adicione apenas drivers que Windows PE (WinPE) requer para inicializar:

  • Certifique-se de que os drivers que você adicionar à imagem de inicialização corresponderão à arquitetura da imagem de inicialização.

  • O WinPE já vem com muitos drivers integrados. Adicione somente drivers de rede e armazenamento que não estão incluídos no WinPE.

  • Adicione somente drivers de rede e armazenamento à imagem de inicialização, a menos que haja requisitos para outros drivers no WinPE.

  • É melhor usar drivers com uma assinatura digital válida.

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

-Confirm

Solicita a confirmação antes de executar o cmdlet.

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

-DisableWildcardHandling

Este parâmetro trata caracteres curinga como valores literais de caracteres. Não é possível combiná-lo com ForceWildcardHandling.

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

-DriverPackage

Especifique uma matriz de objetos de pacote de driver. Para obter esse objeto, use o cmdlet Get-CMDriverPackage.

Use este parâmetro para adicionar os drivers importados aos pacotes de driver especificados.

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

-EnableAndAllowInstall

Habilita o driver e permita que os clientes o instalem durante a etapa de sequência de tarefas Aplicar Automaticamente Driver.

Os drivers adicionados ao pacote de driver não são afetados.

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

-ForceWildcardHandling

Esse parâmetro processa caracteres curinga e pode levar a um comportamento inesperado (não recomendado). Não é possível combiná-lo com DisableWildcardHandling.

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

-ImportDuplicateDriverOption

Especifique como o Configuration Manager gerencia drivers de dispositivo duplicados.

  • AppendCategory: Importar o driver e anexar uma nova categoria às categorias existentes : Importar o driver e - KeepExistingCategory manter as categorias existentes
  • NotImport: Não importe o driver
  • OverwriteCategory: Importe o driver e sobrescreva as categorias existentes
Type:ImportDuplicateDriverOption
Accepted values:NotImport, AppendCategory, KeepExistingCategory, OverwriteCategory
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-ImportFolder

Adicione esse parâmetro para importar todos os drivers de dispositivo na pasta de destino.

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

-Path

Especifique um caminho para os arquivos de driver a importar.

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

-SupportedPlatform

Especifique um objeto de plataforma com suporte ao qual o driver de dispositivo é aplicável e pode ser executado. Para obter esse objeto, use o cmdlet Get-CMSupportedPlatform.

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

-SupportedPlatformName

Especifica uma matriz de nome de plataformas com suporte no qual o driver de dispositivo pode ser executado. Por exemplo, "All Windows 10 (64-bit)".

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

-UpdateBootImageDistributionPoint

Indica se o Configuration Manager atualiza as imagens de inicialização em seus pontos de distribuição para adicionar os novos drivers.

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

-UpdateDriverPackageDistributionPoint

Se você usar o parâmetro -DriverPackage, de definir esse parâmetro como para atualizar o pacote $true de driver em pontos de distribuição atribuídos.

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

-WhatIf

Mostrar o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

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

Entradas

Nenhum

Saídas

IResultObject