Freigeben über

Set-CMDriver

  • Referenz
Modul:
ConfigurationManager

Ändert die Einstellungen eines Gerätetreibers.

Syntax

Set-CMDriver
   [-AddAdministrativeCategory <IResultObject[]>]
   [-AddBootImagePackage <IResultObject[]>]
   [-AddDriverPackage <IResultObject[]>]
   [-AddSupportedPlatformName <String[]>]
   [-AdministrativeCategory <IResultObject[]>]
   [-ClearAdministrativeCategory]
   [-ClearSupportedPlatformName]
   [-Description <String>]
   [-DriverSource <String>]
   [-EnableAndAllowInstall <Boolean>]
   -InputObject <IResultObject>
   [-NewName <String>]
   [-PassThru]
   [-RemoveAdministrativeCategory <IResultObject[]>]
   [-RemoveBootImagePackage <IResultObject[]>]
   [-RemoveDriverPackage <IResultObject[]>]
   [-RemoveSupportedPlatformName <String[]>]
   [-RunOnAnyPlatform]
   [-SupportedPlatformName <String[]>]
   [-UpdateBootImageDistributionPoint <Boolean>]
   [-UpdateDriverDistributionPoint <Boolean>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMDriver
   [-AddAdministrativeCategory <IResultObject[]>]
   [-AddBootImagePackage <IResultObject[]>]
   [-AddDriverPackage <IResultObject[]>]
   [-AddSupportedPlatformName <String[]>]
   [-AdministrativeCategory <IResultObject[]>]
   [-ClearAdministrativeCategory]
   [-ClearSupportedPlatformName]
   [-Description <String>]
   [-DriverSource <String>]
   [-EnableAndAllowInstall <Boolean>]
   -Id <String>
   [-NewName <String>]
   [-PassThru]
   [-RemoveAdministrativeCategory <IResultObject[]>]
   [-RemoveBootImagePackage <IResultObject[]>]
   [-RemoveDriverPackage <IResultObject[]>]
   [-RemoveSupportedPlatformName <String[]>]
   [-RunOnAnyPlatform]
   [-SupportedPlatformName <String[]>]
   [-UpdateBootImageDistributionPoint <Boolean>]
   [-UpdateDriverDistributionPoint <Boolean>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMDriver
   [-AddAdministrativeCategory <IResultObject[]>]
   [-AddBootImagePackage <IResultObject[]>]
   [-AddDriverPackage <IResultObject[]>]
   [-AddSupportedPlatformName <String[]>]
   [-AdministrativeCategory <IResultObject[]>]
   [-ClearAdministrativeCategory]
   [-ClearSupportedPlatformName]
   [-Description <String>]
   [-DriverSource <String>]
   [-EnableAndAllowInstall <Boolean>]
   -Name <String>
   [-NewName <String>]
   [-PassThru]
   [-RemoveAdministrativeCategory <IResultObject[]>]
   [-RemoveBootImagePackage <IResultObject[]>]
   [-RemoveDriverPackage <IResultObject[]>]
   [-RemoveSupportedPlatformName <String[]>]
   [-RunOnAnyPlatform]
   [-SupportedPlatformName <String[]>]
   [-UpdateBootImageDistributionPoint <Boolean>]
   [-UpdateDriverDistributionPoint <Boolean>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Beschreibung

Das Cmdlet Set-CMDriver ändert die Einstellungen eines Gerätetreibers im Treiberkatalog.

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: Ändern eines Treibers

PS XYZ:\> $Driver = Get-CMDriver -Name "cdrom.sys"
PS XYZ:\> Set-CMDriver -InputObject $Driver -NewName "testDriver" -Description "Test configuration" -EnableAndAllowInstall $True -RunOnAnyPlatform $True

Der erste Befehl ruft mithilfe des Cmdlets Get-CMDriver einen Gerätetreiber mit dem Namen cdrom.sys ab. Der Befehl speichert dieses Objekt in der variablen $Driver.

Der zweite Befehl benennt den Treiber um und fügt eine Beschreibung hinzu. Der Befehl gibt Werte für die Parameter EnableAndAllowInstall und RunOnAnyPlatform an.

Beispiel 2: Ändern eines Treibers mithilfe der Pipeline

PS XYZ:\> Get-CMDriver -Name "cdrom.sys" | Set-CMDriver -NewName testDriver -Description description -EnableAndAllowInstall $True -RunOnAnyPlatform $True

Dieser Befehl ruft einen Treiber mit dem Namen cdrom.sys ab und übergibt ihn dann mithilfe des Pipelineoperators an das aktuelle Cmdlet. Das aktuelle Cmdlet benennt den Treiber um und fügt eine Beschreibung hinzu. Der Befehl gibt Werte für EnableAndAllowInstall und RunOnAnyPlatform an.

Parameter

-AddAdministrativeCategory

Gibt ein Array von administrativen Kategorieobjekten an, die dieses Cmdlet einem Treiber hinzufügt. Verwenden Sie zum Abrufen eines administrativen Kategorieobjekts das Cmdlet Get-CMCategory .

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

-AddBootImagePackage

Gibt ein Array von Startimageobjekten an. Verwenden Sie diesen Parameter, um die Startimages anzugeben, die die Gerätetreiber installieren können. Verwenden Sie das Cmdlet Get-CMBootImage , um ein Startimageobjekt abzurufen.

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

-AddDriverPackage

Gibt ein Array von Treiberpaketobjekten an. Verwenden Sie diesen Parameter, um die Treiberpakete anzugeben, die Configuration Manager zum Verteilen der Gerätetreiber verwendet. Verwenden Sie zum Abrufen eines Treiberpaketobjekts das Cmdlet Get-CMDriverPackage .

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

-AddSupportedPlatformName

{{ Fill AddSupportedPlatformName Description }}

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

-AdministrativeCategory

Gibt ein Array von administrativen Kategorien an. Weisen Sie die Gerätetreiber zu Filterzwecken einer administrativen Kategorie zu, z. B. Desktops oder Notebooks-Kategorien.

Verwenden Sie zum Abrufen eines administrativen Kategorieobjekts das Cmdlet Get-CMCategory .

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

-ClearAdministrativeCategory

Gibt an, dass dieses Cmdlet alle administrativen Kategorieobjekte aus dem Treiber entfernt.

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

-ClearSupportedPlatformName

{{ Fill ClearSupportedPlatformName Description }}

Typ:SwitchParameter
Aliase:ClearSupportedPlatformNames
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

-Description

Gibt eine Beschreibung für den Gerätetreiber an.

Typ:String
Position:Named
Standardwert:None
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

-DriverSource

Gibt den Quellspeicherort des Treiberpakets an. Wenn Sie ein Treiberpaket erstellen, muss der Quellspeicherort des Pakets auf eine leere Netzwerkfreigabe verweisen, die nicht von einem anderen Treiberpaket verwendet wird.

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

-EnableAndAllowInstall

Gibt an, ob Configuration Manager die Treiber aktiviert und Computern die Installation der Treiber zulässt.

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

-Id

Gibt die ID eines Gerätetreibers an.

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-InputObject

Gibt ein Treiberobjekt an. Verwenden Sie zum Abrufen eines Treiberobjekts das Cmdlet Get-CMDriver .

Typ:IResultObject
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-Name

Gibt den Namen eines Gerätetreibers an.

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-NewName

Gibt einen neuen Namen für den Gerätetreiber an.

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

-PassThru

Gibt ein Objekt zurück, das den Treiber darstellt. Standardmäßig wird von diesem Cmdlet keine Ausgabe generiert.

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

-RemoveAdministrativeCategory

Gibt ein Array von administrativen Kategorieobjekten an, die dieses Cmdlet aus einem Treiber entfernt. Verwenden Sie Get-CMCategory, um ein administratives Kategorieobjekt abzurufen.

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

-RemoveBootImagePackage

Gibt ein Array von Startimageobjekten an. Verwenden Sie diesen Parameter, um die Startimages zu entfernen, die den Gerätetreiber installieren können. Verwenden Sie das Cmdlet Get-CMBootImage , um ein Startimageobjekt abzurufen.

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

-RemoveDriverPackage

Gibt ein Array von Treiberpaketobjekten an. Verwenden Sie diesen Parameter, um die Treiberpakete zu entfernen, die Configuration Manager zum Verteilen der Gerätetreiber verwendet. Verwenden Sie zum Abrufen eines Treiberpaketobjekts das Cmdlet Get-CMDriverPackage .

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

-RemoveSupportedPlatformName

{{ Fill RemoveSupportedPlatformName Description }}

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

-RunOnAnyPlatform

Gibt an, dass der Gerätetreiber auf allen Plattformen ausgeführt werden kann.

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

-SupportedPlatformName

Gibt ein Array von Namen von Plattformen an, auf denen der Gerätetreiber ausgeführt werden kann.

Typ:String[]
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

-UpdateDriverDistributionPoint

Gibt an, dass Configuration Manager Verteilungspunkte aktualisiert, wenn der Gerätetreiber dem Treiberpaket hinzugefügt wird.

Typ:Boolean
Aliase:UpdateDistributionPointsForDriverPackage, UpdateDriverDistributionPoints
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

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Ausgaben

System.Object