Compartilhar via

Import-CMDriver

  • Referência
Módulo:
ConfigurationManager

Importe um controlador de dispositivo para o catálogo de controladores.

Sintaxe

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 controladores de dispositivo para o catálogo de controladores no Configuration Manager. Ao importar controladores de dispositivo para o catálogo, pode adicionar os controladores de dispositivo aos pacotes de controladores ou aos pacotes de imagem de arranque.

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

  • Provedor
  • Classe
  • Versão
  • Assinatura
  • Hardware suportado
  • Plataforma suportada

Por predefinição, o controlador tem o nome do primeiro dispositivo de hardware que suporta. Para mudar o nome do controlador de dispositivo, utilize o parâmetro -NewName do cmdlet Set-CMDriver . A lista de plataformas suportadas baseia-se nas informações no ficheiro INF do controlador. Uma vez que a precisão destas informações pode variar, verifique manualmente se o controlador de dispositivo é suportado depois de o importar para o catálogo de controladores.

Observação

Execute cmdlets do Configuration Manager a partir da unidade do site do Configuration Manager, por exemplo PS XYZ:\>. Para obter mais informações, veja Introdução.

Exemplos

Exemplo 1: Importar todos os controladores de dispositivo num caminho

Este comando importa todos os controladores de dispositivo localizados no caminho \\Server1\Driverde rede .

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

Exemplo 2: Importar um controlador de dispositivo pelo nome

Este comando importa o controlador denominado driver.inf a partir do caminho \\Server1\Driverde rede .

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

Parâmetros

-AdministrativeCategory

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

Atribua os controladores de dispositivo a uma categoria para fins de filtragem, como Computadores de Secretária ou Blocos de Notas.

Tipo:IResultObject[]
Aliases:AdministrativeCategories
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-AdministrativeCategoryName

Em vez de obter e especificar um objeto para uma categoria com o parâmetro AdministrativeCategory , utilize este parâmetro para especificar simplesmente o nome de uma categoria. Também pode utilizar uma matriz de nomes de categorias.

Tipo:String[]
Aliases:AdministrativeCategoryNames
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-BootImagePackage

Especifique uma matriz de objetos de imagem de arranque. Para obter este objeto, utilize o cmdlet Get-CMBootImage .

Utilize este parâmetro para adicionar os controladores importados às imagens de arranque especificadas.

Adicione apenas controladores que o Windows PE (WinPE) necessita para arrancar:

  • Certifique-se de que os controladores que adiciona à imagem de arranque correspondem à arquitetura da imagem de arranque.

  • O WinPE já vem com muitos controladores incorporados. Adicione apenas controladores de rede e armazenamento que não estão incluídos no WinPE.

  • Adicione apenas controladores de rede e armazenamento à imagem de arranque, a menos que existam requisitos para outros controladores no WinPE.

  • É melhor utilizar controladores com uma assinatura digital válida.

Tipo:IResultObject[]
Aliases:BootImagePackages
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Confirm

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

Tipo:SwitchParameter
Aliases:cf
Cargo:Named
Valor padrão:False
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DisableWildcardHandling

Este parâmetro trata os carateres universais como valores de carateres literais. Não pode combiná-lo com ForceWildcardHandling.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DriverPackage

Especifique uma matriz de objetos de pacote de controlador. Para obter este objeto, utilize o cmdlet Get-CMDriverPackage .

Utilize este parâmetro para adicionar os controladores importados aos pacotes de controladores especificados.

Tipo:IResultObject[]
Aliases:DriverPackages
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-EnableAndAllowInstall

Ative o controlador e permita que os clientes o instalem durante o passo de sequência de tarefas Aplicar Controlador Automaticamente .

Os controladores adicionados ao pacote de controladores não são afetados.

Tipo:Boolean
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ForceWildcardHandling

Este parâmetro processa carateres universais e pode levar a um comportamento inesperado (não recomendado). Não pode combiná-lo com DisableWildcardHandling.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ImportDuplicateDriverOption

Especifique a forma como o Configuration Manager gere controladores de dispositivo duplicados.

  • AppendCategory: importe o controlador e acrescente uma nova categoria às categorias existentes - KeepExistingCategory: Importe o controlador e mantenha as categorias existentes
  • NotImport: Não importe o controlador
  • OverwriteCategory: importe o controlador e substitua as categorias existentes
Tipo:ImportDuplicateDriverOption
Valores aceitos:NotImport, AppendCategory, KeepExistingCategory, OverwriteCategory
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ImportFolder

Adicione este parâmetro para importar todos os controladores de dispositivo na pasta de destino.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Path

Especifique um caminho para os ficheiros de controlador a importar.

Tipo:String
Aliases:FileName, FilePath, ImportFilePath, Location, UncFileLocation
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-SupportedPlatform

Especifique um objeto de plataforma suportado ao qual o controlador de dispositivo é aplicável e pode ser executado. Para obter este objeto, utilize o cmdlet Get-CMSupportedPlatform .

Tipo:IResultObject[]
Aliases:SupportedPlatforms
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-SupportedPlatformName

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

Tipo:String[]
Aliases:SupportedPlatformNames
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-UpdateBootImageDistributionPoint

Indica se o Configuration Manager atualiza as imagens de arranque nos respetivos pontos de distribuição para adicionar os novos controladores.

Tipo:Boolean
Aliases:UpdateDistributionPointsForBootImagePackage, UpdateBootImageDistributionPoints
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-UpdateDriverPackageDistributionPoint

Se utilizar o parâmetro -DriverPackage , defina este parâmetro como $true para atualizar o pacote de controlador em pontos de distribuição atribuídos.

Tipo:Boolean
Aliases:UpdateDistributionPointsforDriverPackage
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-WhatIf

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

Tipo:SwitchParameter
Aliases:wi
Cargo:Named
Valor padrão:False
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

Entradas

None

Saídas

IResultObject