Set-CMDriverPackage
Ä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 auf dem Configuration Manager-Standortlaufwerk aus, z. B PS XYZ:\>. . 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.
| Typ: | SwitchParameter |
| Aliase: | cf |
| Position: | Named |
| Standardwert: | False |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-CopyToPackageShareOnDistributionPoint
Clients können immer ein Treiberpaket von einem Verteilungspunkt herunterladen. Wenn Sie diesen Parameter auf $true festlegen, stellt der Standort ihn über eine benannte Netzwerkfreigabe auf Verteilungspunkten zur Verfügung. Verwenden Sie CustomPackageShareName , um einen benutzerdefinierten Freigabenamen anzugeben.
Wenn Sie diese Option aktivieren, ist mehr Platz auf Verteilungspunkten erforderlich. Sie gilt für alle Verteilungspunkte, an die Sie dieses Treiberpaket verteilen.
| Typ: | Boolean |
| Aliase: | CopyToPackageShareOnDistributionPoints |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-CustomPackageShareName
Wenn Sie CopyToPackageShareOnDistributionPoint aktivieren, können Sie diesen Parameter verwenden, um den Freigabenamen anzupassen. Die maximale Länge beträgt 127 Zeichen und darf keines der folgenden Zeichen enthalten: " / [ ] : | < > + = ; , ? *. Sie können einen Freigabenamen und einen Ordnernamen angeben, aber dann beträgt der Höchstwert für jede 80 Zeichen. Beispiel: ShareName\FolderName.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-Description
Geben Sie eine optionale Beschreibung eines Treiberpakets an, damit Sie es leichter identifizieren können.
| 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 |
-DisconnectUserFromDistributionPoint
Diese Option ist veraltet. Es legt die ForcedDisconnectEnabled-Eigenschaft des Treiberpakets fest.
| Typ: | Boolean |
| Aliase: | DisconnectUsersFromDistributionPoints |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-DisconnectUserFromDistributionPointMins
Diese Option ist veraltet. Es legt die ForcedDisconnectDelay-Eigenschaft des Treiberpakets fest.
| Typ: | UInt32 |
| Aliase: | DisconnectUsersFromDistributionPointsMinutes |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-DisconnectUserFromDistributionPointRetryCount
Diese Option ist veraltet. Es legt die ForcedDisconnectNumRetries-Eigenschaft des Treiberpakets fest.
| Typ: | UInt32 |
| Aliase: | DisconnectUsersFromDistributionPointsRetries |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-DistributionPointUpdateSchedule
Verwenden Sie diesen Parameter, um Verteilungspunkte nach einem Zeitplan zu aktualisieren. Verwenden Sie zum Abrufen eines Zeitplanobjekts das Cmdlet New-CMSchedule .
| Typ: | IResultObject |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-DriverManufacturer
Verwenden Sie diesen Parameter, um den Hersteller des Geräts festzulegen. Die maximale Länge beträgt 100 Zeichen.
Verwenden Sie es mit dem DriverModel-Parameter . Sie können sie für die Verwaltung des Treiberkatalogs und für die Vorabzwischenspeicherung der Tasksequenz verwenden. Weitere Informationen finden Sie unter Konfigurieren von Vorabcacheinhalten für Tasksequenzen.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-DriverModel
Verwenden Sie diesen Parameter, um das Modell des Geräts festzulegen. Die maximale Länge beträgt 100 Zeichen.
Verwenden Sie es mit dem Parameter DriverManufacturer . Sie können sie für die Verwaltung des Treiberkatalogs und für die Vorabzwischenspeicherung der Tasksequenz verwenden. Weitere Informationen finden Sie unter Konfigurieren von Vorabcacheinhalten für Tasksequenzen.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | 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.
| Typ: | String |
| 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
Geben Sie die ID eines zu konfigurierenden Treiberpakets an. Dieser Wert ist eine Standardpaket-ID, z. B.: XYZ00020.
| Typ: | String |
| Aliase: | PackageId |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-InputObject
Geben Sie ein zu konfigurierenes Treiberpaketobjekt an. Verwenden Sie zum Abrufen dieses Objekts das Cmdlet Get-CMDriverPackage .
| Typ: | IResultObject |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | True |
| Platzhalterzeichen akzeptieren: | 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.
| Typ: | Boolean |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-MulticastEncrypt
Wenn Sie MulticastAllow aktivieren, legen Sie diesen Parameter auf $true fest, um Multicastpakete zu verschlüsseln.
| Typ: | Boolean |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-MulticastTransferOnly
Wenn Sie MulticastAllow aktivieren, legen Sie diesen Parameter auf $true fest, um dieses Treiberpaket nur über Multicast zu übertragen.
| Typ: | Boolean |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-Name
Geben Sie den Namen eines zu konfigurierenden Treiberpakets an.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-NewName
Geben Sie einen neuen Namen für das Treiberpaket an.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | 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.
| Typ: | SwitchParameter |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-PrestageBehavior
Geben Sie das Verhalten an, wenn Sie einen Verteilungspunkt für vorab bereitgestellten Inhalt aktivieren:
-
ManualCopy: Manuelles Kopieren des Inhalts in diesem Paket auf den Verteilungspunkt -
DownloadDelta: Nur Inhaltsänderungen auf den Verteilungspunkt herunterladen -
OnDemand: Inhalt automatisch herunterladen, wenn Pakete Verteilungspunkten zugewiesen sind
Weitere Informationen finden Sie unter Verwenden von vorab bereitgestelltem Inhalt.
| Typ: | PrestageBehavior |
| Zulässige Werte: | ManualCopy, DownloadDelta, OnDemand |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-Priority
Geben Sie die Reihenfolge an, in der der Standort den Inhalt an andere Standorte sendet, und die Verteilungspunkte an diesem Standort.
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.
| Typ: | Priority |
| Zulässige Werte: | High, Medium, Low |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-SendToPreferredDistributionPoint
Wenn Sie die bedarfsgesteuerte Inhaltsverteilung an bevorzugte Verteilungspunkte aktivieren möchten, legen Sie diesen Parameter auf $true fest. Wenn Sie diese Einstellung aktivieren und ein Client den Inhalt für das Paket anfordert und der Inhalt auf keinen Verteilungspunkten verfügbar ist, verteilt der Verwaltungspunkt den Inhalt. Weitere Informationen finden Sie unter Bedarfsgesteuerte Inhaltsverteilung.
| Typ: | Boolean |
| Aliase: | SendToPreferredDistributionPoints |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-Version
Geben Sie die Version des Treiberpakets an. Dieser Wert ist eine Zeichenfolge, die Sie verwalten.
| Typ: | String |
| 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