Set-CMDriverPackage

Referenz

Modul:: ConfigurationManager

Ändern eines Treiberpakets.

Syntax

Set-CMDriverPackage
   [-CopyToPackageShareOnDistributionPoint <Boolean>]
   [-CustomPackageShareName <String>]
   [-Description <String>]
   [-DisconnectUserFromDistributionPoint <Boolean>]
   [-DisconnectUserFromDistributionPointMins <UInt32>]
   [-DisconnectUserFromDistributionPointRetryCount <UInt32>]
   [-DistributionPointUpdateSchedule <IResultObject>]
   [-DriverManufacturer <String>]
   [-DriverModel <String>]
   [-DriverPackageSource <String>]
   -InputObject <IResultObject>
   [-MulticastAllow <Boolean>]
   [-MulticastEncrypt <Boolean>]
   [-MulticastTransferOnly <Boolean>]
   [-NewName <String>]
   [-PassThru]
   [-PrestageBehavior <PrestageBehavior>]
   [-Priority <Priority>]
   [-SendToPreferredDistributionPoint <Boolean>]
   [-Version <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-CMDriverPackage
   [-CopyToPackageShareOnDistributionPoint <Boolean>]
   [-CustomPackageShareName <String>]
   [-Description <String>]
   [-DisconnectUserFromDistributionPoint <Boolean>]
   [-DisconnectUserFromDistributionPointMins <UInt32>]
   [-DisconnectUserFromDistributionPointRetryCount <UInt32>]
   [-DistributionPointUpdateSchedule <IResultObject>]
   [-DriverManufacturer <String>]
   [-DriverModel <String>]
   [-DriverPackageSource <String>]
   -Id <String>
   [-MulticastAllow <Boolean>]
   [-MulticastEncrypt <Boolean>]
   [-MulticastTransferOnly <Boolean>]
   [-NewName <String>]
   [-PassThru]
   [-PrestageBehavior <PrestageBehavior>]
   [-Priority <Priority>]
   [-SendToPreferredDistributionPoint <Boolean>]
   [-Version <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-CMDriverPackage
   [-CopyToPackageShareOnDistributionPoint <Boolean>]
   [-CustomPackageShareName <String>]
   [-Description <String>]
   [-DisconnectUserFromDistributionPoint <Boolean>]
   [-DisconnectUserFromDistributionPointMins <UInt32>]
   [-DisconnectUserFromDistributionPointRetryCount <UInt32>]
   [-DistributionPointUpdateSchedule <IResultObject>]
   [-DriverManufacturer <String>]
   [-DriverModel <String>]
   [-DriverPackageSource <String>]
   [-MulticastAllow <Boolean>]
   [-MulticastEncrypt <Boolean>]
   [-MulticastTransferOnly <Boolean>]
   -Name <String>
   [-NewName <String>]
   [-PassThru]
   [-PrestageBehavior <PrestageBehavior>]
   [-Priority <Priority>]
   [-SendToPreferredDistributionPoint <Boolean>]
   [-Version <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Beschreibung

Verwenden Sie dieses Cmdlet, um ein Treiberpaket zu ändern.

Weitere Informationen finden Sie unter Verwalten von Treibern in Configuration Manager.

Hinweis

Führen Sie Configuration Manager-Cmdlets beispielsweise vom Configuration Manager-Standortlaufwerk PS XYZ:\> aus. Weitere Informationen finden Sie unter "Erste Schritte".

Beispiele

Beispiel 1: Konfigurieren des Herstellers und Modells eines Treiberpakets

Dieser Befehl konfiguriert den Hersteller und das Modell des Treiberpakets mit der ID XYZ00091.

Set-CMDriverPackage -PackageId "XYZ00091" -DriverManufacturer "Microsoft" -DriverModel "Surface 2"

Parameter

-Confirm

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

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

-CopyToPackageShareOnDistributionPoint

Clients können immer ein Treiberpaket von einem Verteilungspunkt herunterladen. Wenn Sie diesen Parameter auf $truefestlegen, stellt der Standort ihn über eine benannte Netzwerkfreigabe an Verteilungspunkten zur Verfügung. Verwenden Sie CustomPackageShareName, um einen benutzerdefinierten Freigabenamen anzugeben.

Wenn Sie diese Option aktivieren, ist mehr Speicherplatz für Verteilungspunkte erforderlich. Sie gilt für alle Verteilungspunkte, an die Sie dieses Treiberpaket verteilen.

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

-CustomPackageShareName

Wenn Sie CopyToPackageShareOnDistributionPointaktivieren, können Sie diesen Parameter verwenden, um den Freigabenamen anzupassen. Die maximale Länge beträgt 127 Zeichen und kann keines der folgenden Zeichen enthalten: " / [ ] : | < > + = ; , ? * . Sie können einen Freigabenamen und einen Ordnernamen angeben, aber dann beträgt das Maximum 80 Zeichen. Beispiel: ShareName\FolderName.

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

-Description

Geben Sie eine optionale Beschreibung eines Treiberpakets an, um es zu identifizieren.

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

-DisableWildcardHandling

Dieser Parameter behandelt Platzhalterzeichen als Literalzeichenwerte. Sie können es nicht mit ForceWildcardHandlingkombinieren.

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

-DisconnectUserFromDistributionPoint

Diese Option ist veraltet. Sie legt die ForcedDisconnectEnabled-Eigenschaft des Treiberpakets fest.

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

-DisconnectUserFromDistributionPointMins

Diese Option ist veraltet. Sie legt die ForcedDisconnectDelay-Eigenschaft des Treiberpakets fest.

Type:	UInt32
Aliases:	DisconnectUsersFromDistributionPointsMinutes
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-DisconnectUserFromDistributionPointRetryCount

Diese Option ist veraltet. Sie legt die ForcedDisconnectNumRetries-Eigenschaft des Treiberpakets fest.

Type:	UInt32
Aliases:	DisconnectUsersFromDistributionPointsRetries
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-DistributionPointUpdateSchedule

Verwenden Sie diesen Parameter, um Verteilungspunkte nach einem Zeitplan zu aktualisieren. Verwenden Sie zum Abrufen eines Zeitplanobjekts das Cmdlet "New-CMSchedule".

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

-DriverManufacturer

Verwenden Sie diesen Parameter, um den Hersteller des Geräts festzulegen. Die maximale Länge beträgt 100 Zeichen.

Verwenden Sie ihn mit dem DriverModel-Parameter. Sie können sie für die Verwaltung des Treiberkatalogs und für die Tasksequenz vor dem Zwischenspeichern verwenden. Weitere Informationen finden Sie unter Konfigurieren von Inhalten vor dem Cache für Tasksequenzen.

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

-DriverModel

Verwenden Sie diesen Parameter, um das Modell des Geräts festzulegen. Die maximale Länge beträgt 100 Zeichen.

Verwenden Sie ihn mit dem DriverManufacturer-Parameter. Sie können sie für die Verwaltung des Treiberkatalogs und für die Tasksequenz vor dem Zwischenspeichern verwenden. Weitere Informationen finden Sie unter Konfigurieren von Inhalten vor dem Cache für Tasksequenzen.

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

-DriverPackageSource

Geben Sie einen Dateipfad zum Netzwerkspeicherort an, um die Treiberdateien zu beziehen.

Wenn Sie ein Treiberpaket erstellen, muss der Quellspeicherort des Pakets auf eine leere Netzwerkfreigabe verweisen, die nicht von einem anderen Treiberpaket verwendet wird. Der SMS-Anbieter muss über Vollzugriffsberechtigungen für diesen Standort verfügen.

Wenn Sie einem Treiberpaket Gerätetreiber hinzufügen, kopiert Configuration Manager es in diesen Pfad. Sie können einem Treiberpaket nur Gerätetreiber hinzufügen, die Sie importiert haben und die im Treiberkatalog aktiviert sind.

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

-ForceWildcardHandling

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

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

-Id

Geben Sie die ID eines zu konfigurierenden Treiberpakets an. Dieser Wert ist eine Standardpaket-ID, z. B.: XYZ00020 .

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

-InputObject

Geben Sie ein treiberpaketobjekt an, das konfiguriert werden soll. Verwenden Sie zum Abrufen dieses Objekts das Cmdlet "Get-CMDriverPackage".

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

-MulticastAllow

Legen Sie diesen Parameter auf $true fest, damit dieses Paket über Multicast übertragen werden kann. Weitere Informationen finden Sie unter Verwenden von Multicast zum Bereitstellen von Windows über das Netzwerk mit Configuration Manager.

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

-MulticastEncrypt

Wenn Sie MulticastAllowaktivieren, legen Sie diesen Parameter auf $true fest, um Multicastpakete zu verschlüsseln.

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

-MulticastTransferOnly

Wenn Sie MulticastAllowaktivieren, legen Sie diesen Parameter auf $true fest, um dieses Treiberpaket nur über Multicast zu übertragen.

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

-Name

Geben Sie den Namen eines zu konfigurierenden Treiberpakets an.

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

-NewName

Geben Sie einen neuen Namen für das Treiberpaket an.

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

-PassThru

Fügen Sie diesen Parameter hinzu, um ein Objekt zurückzugeben, das das Element darstellt, mit dem Sie arbeiten. Standardmäßig generiert dieses Cmdlet möglicherweise keine Ausgabe.

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

-PrestageBehavior

Geben Sie das Verhalten an, wenn Sie einen Verteilungspunkt für Vorabinhalte aktivieren:

ManualCopy: Manuelles Kopieren des Inhalts in diesem Paket an den Verteilungspunkt
DownloadDelta: Nur Inhaltsänderungen an den Verteilungspunkt herunterladen
OnDemand: Inhalte automatisch herunterladen, wenn Pakete Verteilungspunkten zugewiesen sind

Weitere Informationen finden Sie unter Verwenden vorab verwendeter Inhalte.

Type:	PrestageBehavior
Accepted values:	ManualCopy, DownloadDelta, OnDemand
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-Priority

Geben Sie die Reihenfolge an, in der die Website den Inhalt an andere Websites und die Verteilungspunkte auf dieser Website sendet.

Die Website sendet Inhalte mit hoher Priorität vor Paketen mit mittlerer oder niedriger Priorität. Pakete mit gleicher Priorität werden in der Reihenfolge gesendet, in der sie erstellt werden.

Type:	Priority
Accepted values:	High, Medium, Low
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-SendToPreferredDistributionPoint

Wenn Sie die On-Demand-Inhaltsverteilung auf bevorzugte Verteilungspunkte aktivieren möchten, legen Sie diesen Parameter auf $truefest. Wenn Sie diese Einstellung aktivieren und ein Client den Inhalt für das Paket anfordert und der Inhalt an keinen Verteilungspunkten verfügbar ist, verteilt der Verwaltungspunkt den Inhalt. Weitere Informationen finden Sie unter On-Demand Content Distribution.

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

-Version

Geben Sie die Version des Treiberpakets an. Dieser Wert ist eine Zeichenfolge, die Sie verwalten.

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

Eingaben

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Ausgaben

System.Object