Set-CMDriver

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-Websitelaufwerk aus, z. PS XYZ:\>B. . 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 .

Type:	IResultObject[]
Aliases:	AddAdministrativeCategories
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	IResultObject[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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 .

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

-AddSupportedPlatformName

{{ Fill AddSupportedPlatformName Description }}

Type:	String[]
Aliases:	AddSupportedPlatformNames
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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 .

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

-ClearAdministrativeCategory

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

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

-ClearSupportedPlatformName

{{ Fill ClearSupportedPlatformName Description }}

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

-Confirm

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

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

-Description

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

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

-DisableWildcardHandling

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

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

-EnableAndAllowInstall

Gibt an, ob Configuration Manager die Treiber aktiviert und Computern die Installation der Treiber ermöglicht.

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

-ForceWildcardHandling

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

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

-Id

Gibt die ID eines Gerätetreibers an.

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-InputObject

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

Type:	IResultObject
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-Name

Gibt den Namen eines Gerätetreibers an.

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-NewName

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

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

-PassThru

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	IResultObject[]
Aliases:	RemoveAdministrativeCategories
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	IResultObject[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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 .

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

-RemoveSupportedPlatformName

{{ Fill RemoveSupportedPlatformName Description }}

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

-RunOnAnyPlatform

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

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

-SupportedPlatformName

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

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

-UpdateBootImageDistributionPoint

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

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

-UpdateDriverDistributionPoint

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

Type:	Boolean
Aliases:	UpdateDistributionPointsForDriverPackage, UpdateDriverDistributionPoints
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-WhatIf

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

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

Eingaben

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Ausgaben

System.Object

Ähnliche Themen

• Disable-CMDriver
• Enable-CMDriver
• Get-CMDriver
• Import-CMDriver
• Remove-CMDriver
• Get-CMCategory
• Get-CMBootImage
• Get-CMDriverPackage