Freigeben über

Import-CMDriver

  • Referenz
Modul:
ConfigurationManager

Importieren Sie einen Gerätetreiber in den Treiberkatalog.

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>]

Beschreibung

Das Cmdlet Import-CMDriver importiert mindestens einen Gerätetreiber in den Treiberkatalog in Configuration Manager. Wenn Sie Gerätetreiber in den Katalog importieren, können Sie die Gerätetreiber zu Treiberpaketen oder zum Starten von Imagepaketen hinzufügen.

Im Rahmen des Importvorgangs für den Gerätetreiber liest Configuration Manager die folgenden Informationen, die dem Gerät zugeordnet sind:

  • Anbieter
  • Klasse
  • Version
  • Signatur
  • Unterstützte Hardware
  • Unterstützte Plattform

Standardmäßig wird der Treiber nach dem ersten Hardwaregerät benannt, das er unterstützt. Verwenden Sie zum Umbenennen des Gerätetreibers den Parameter -NewName des Cmdlets Set-CMDriver . Die Liste der unterstützten Plattformen basiert auf den Informationen in der INF-Datei des Treibers. Da die Genauigkeit dieser Informationen variieren kann, überprüfen Sie manuell, ob der Gerätetreiber unterstützt wird, nachdem Sie ihn in den Treiberkatalog importiert haben.

Hinweis

Führen Sie Configuration Manager-Cmdlets auf dem Configuration Manager-Standortlaufwerk aus, z. B PS XYZ:\>. . Weitere Informationen finden Sie unter Erste Schritte.

Beispiele

Beispiel 1: Importieren aller Gerätetreiber in einem Pfad

Dieser Befehl importiert alle Gerätetreiber, die sich im Netzwerkpfad \\Server1\Driverbefinden.

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

Beispiel 2: Importieren eines Gerätetreibers anhand des Namens

Mit diesem Befehl wird der Treiber driver.inf aus dem Netzwerkpfad \\Server1\Driverimportiert.

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

Parameter

-AdministrativeCategory

Geben Sie ein Array von Kategorieobjekten an. Verwenden Sie zum Abrufen dieses Objekts das Cmdlet Get-CMCategory .

Weisen Sie die Gerätetreiber zu Filterzwecken einer Kategorie zu, z. B. Desktops oder Notebooks.

Typ:IResultObject[]
Aliase:AdministrativeCategories
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-AdministrativeCategoryName

Anstatt ein Objekt für eine Kategorie mit dem Parameter AdministrativeCategory zu erhalten und anzugeben, verwenden Sie diesen Parameter, um einfach den Namen einer Kategorie anzugeben. Sie können auch ein Array von Kategorienamen verwenden.

Typ:String[]
Aliase:AdministrativeCategoryNames
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-BootImagePackage

Geben Sie ein Array von Startimageobjekten an. Verwenden Sie zum Abrufen dieses Objekts das Cmdlet Get-CMBootImage .

Verwenden Sie diesen Parameter, um den angegebenen Startimages die importierten Treiber hinzuzufügen.

Fügen Sie nur Treiber hinzu, die Windows PE (WinPE) zum Starten benötigt:

  • Stellen Sie sicher, dass die Treiber, die Sie dem Startimage hinzufügen, mit der Architektur des Startimages übereinstimmen.

  • WinPE verfügt bereits über viele integrierte Treiber. Fügen Sie nur Netzwerk- und Speichertreiber hinzu, die nicht in WinPE enthalten sind.

  • Fügen Sie dem Startimage nur Netzwerk- und Speichertreiber hinzu, es sei denn, es bestehen Anforderungen für andere Treiber in WinPE.

  • Es empfiehlt sich, Treiber mit einer gültigen digitalen Signatur zu verwenden.

Typ:IResultObject[]
Aliase:BootImagePackages
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Confirm

Fordert Sie vor dem Ausführen des Cmdlets zur Bestätigung auf.

Typ:SwitchParameter
Aliase:cf
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DisableWildcardHandling

Dieser Parameter behandelt Wildcardzeichen als Literalzeichenwerte. Sie können es nicht mit ForceWildcardHandling kombinieren.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DriverPackage

Geben Sie ein Array von Treiberpaketobjekten an. Verwenden Sie zum Abrufen dieses Objekts das Cmdlet Get-CMDriverPackage .

Verwenden Sie diesen Parameter, um die importierten Treiber den angegebenen Treiberpaketen hinzuzufügen.

Typ:IResultObject[]
Aliase:DriverPackages
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-EnableAndAllowInstall

Aktivieren Sie den Treiber, und erlauben Sie Clients, ihn während des Tasksequenzschritts Treiber automatisch anwenden zu installieren.

Treiber, die dem Treiberpaket hinzugefügt wurden, sind nicht betroffen.

Typ:Boolean
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ForceWildcardHandling

Dieser Parameter verarbeitet Wildcardzeichen und kann zu unerwartetem Verhalten führen (nicht empfohlen). Sie können es nicht mit DisableWildcardHandling kombinieren.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ImportDuplicateDriverOption

Geben Sie an, wie Configuration Manager doppelte Gerätetreiber verwaltet.

  • AppendCategory: Importieren sie den Treiber, und fügen Sie eine neue Kategorie an die vorhandenen Kategorien - KeepExistingCategoryan: Importieren Sie den Treiber, und behalten Sie die vorhandenen Kategorien bei.
  • NotImport: Importieren Sie den Treiber nicht.
  • OverwriteCategory: Importieren des Treibers und Überschreiben der vorhandenen Kategorien
Typ:ImportDuplicateDriverOption
Zulässige Werte:NotImport, AppendCategory, KeepExistingCategory, OverwriteCategory
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ImportFolder

Fügen Sie diesen Parameter hinzu, um alle Gerätetreiber im Zielordner zu importieren.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Path

Geben Sie einen Pfad zu den zu importierenden Treiberdateien an.

Typ:String
Aliase:FileName, FilePath, ImportFilePath, Location, UncFileLocation
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-SupportedPlatform

Geben Sie ein unterstütztes Plattformobjekt an, für das der Gerätetreiber anwendbar ist und ausgeführt werden kann. Verwenden Sie zum Abrufen dieses Objekts das Cmdlet Get-CMSupportedPlatform .

Typ:IResultObject[]
Aliase:SupportedPlatforms
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-SupportedPlatformName

Gibt ein Array unterstützter Plattformnamen an, auf dem der Gerätetreiber ausgeführt werden kann. Beispiel: "All Windows 10 (64-bit)".

Typ:String[]
Aliase:SupportedPlatformNames
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-UpdateBootImageDistributionPoint

Gibt an, ob Configuration Manager Startimages auf ihren Verteilungspunkten aktualisiert, um die neuen Treiber hinzuzufügen.

Typ:Boolean
Aliase:UpdateDistributionPointsForBootImagePackage, UpdateBootImageDistributionPoints
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-UpdateDriverPackageDistributionPoint

Wenn Sie den Parameter -DriverPackage verwenden, legen Sie diesen Parameter auf fest $true , um das Treiberpaket auf zugewiesenen Verteilungspunkten zu aktualisieren.

Typ:Boolean
Aliase:UpdateDistributionPointsforDriverPackage
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-WhatIf

Zeigt, was passieren würde, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Typ:SwitchParameter
Aliase:wi
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Eingaben

None

Ausgaben

IResultObject