Set-CMPackage
Ändern eines Pakets.
Syntax
Set-CMPackage
[-CopyToPackageShareOnDistributionPoint <Boolean>]
[-CustomPackageShareName <String>]
[-Description <String>]
[-DisconnectUserFromDistributionPoint <Boolean>]
[-DisconnectUserFromDistributionPointMins <UInt32>]
[-DisconnectUserFromDistributionPointRetry <UInt32>]
[-DistributionPointUpdateSchedule <IResultObject>]
[-EnableBinaryDeltaReplication <Boolean>]
[-InputObject] <IResultObject>
[-Language <String>]
[-Manufacturer <String>]
[-MifFileName <String>]
[-MifName <String>]
[-MifPublisher <String>]
[-MifVersion <String>]
[-MulticastAllow <Boolean>]
[-MulticastEncrypt <Boolean>]
[-MulticastTransferOnly <Boolean>]
[-NewName <String>]
[-PassThru]
[-Path <String>]
[-PersistContentInCache <Boolean>]
[-PrestageBehavior <PrestageBehavior>]
[-Priority <Priorities>]
[-SendToPreferredDistributionPoint <Boolean>]
[-Version <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]Set-CMPackage
[-CopyToPackageShareOnDistributionPoint <Boolean>]
[-CustomPackageShareName <String>]
[-Description <String>]
[-DisconnectUserFromDistributionPoint <Boolean>]
[-DisconnectUserFromDistributionPointMins <UInt32>]
[-DisconnectUserFromDistributionPointRetry <UInt32>]
[-DistributionPointUpdateSchedule <IResultObject>]
[-EnableBinaryDeltaReplication <Boolean>]
-Id <String>
[-Language <String>]
[-Manufacturer <String>]
[-MifFileName <String>]
[-MifName <String>]
[-MifPublisher <String>]
[-MifVersion <String>]
[-MulticastAllow <Boolean>]
[-MulticastEncrypt <Boolean>]
[-MulticastTransferOnly <Boolean>]
[-NewName <String>]
[-PassThru]
[-Path <String>]
[-PersistContentInCache <Boolean>]
[-PrestageBehavior <PrestageBehavior>]
[-Priority <Priorities>]
[-SendToPreferredDistributionPoint <Boolean>]
[-Version <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]Set-CMPackage
[-CopyToPackageShareOnDistributionPoint <Boolean>]
[-CustomPackageShareName <String>]
[-Description <String>]
[-DisconnectUserFromDistributionPoint <Boolean>]
[-DisconnectUserFromDistributionPointMins <UInt32>]
[-DisconnectUserFromDistributionPointRetry <UInt32>]
[-DistributionPointUpdateSchedule <IResultObject>]
[-EnableBinaryDeltaReplication <Boolean>]
[-Language <String>]
[-Manufacturer <String>]
[-MifFileName <String>]
[-MifName <String>]
[-MifPublisher <String>]
[-MifVersion <String>]
[-MulticastAllow <Boolean>]
[-MulticastEncrypt <Boolean>]
[-MulticastTransferOnly <Boolean>]
-Name <String>
[-NewName <String>]
[-PassThru]
[-Path <String>]
[-PersistContentInCache <Boolean>]
[-PrestageBehavior <PrestageBehavior>]
[-Priority <Priorities>]
[-SendToPreferredDistributionPoint <Boolean>]
[-Version <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]Beschreibung
Verwenden Sie dieses Cmdlet, um die Einstellungen eines Pakets zu ändern. Weitere Informationen finden Sie unter Pakete und Programme 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: Umbenennen eines Pakets und Hinzufügen einer Beschreibung
Dieser Befehl benennt das Paket mit der ID ST120001 in ScriptsPackage02 um und fügt eine Beschreibung hinzu.
Set-CMPackage -Id "ST120001" -NewName "ScriptsPackage02" -Description "This package deploys scripts that run on a recurring schedule."Beispiel 2: Ändern des Paketquellpfads
Der erste Befehl ruft das Paket ab, das über die ID ST120001 verfügt, und speichert die Ergebnisse in der variablen $Pkg . Der zweite Befehl ändert den Pfad der Paketquelle.
$pkg = Get-CMPackage -Id "ST120001"
Set-CMPackage -InputObject $pkg -Path "\\sources\cmpkg$\newpkg01"Parameter
-Confirm
Fügen Sie diesen Parameter hinzu, um vor der Ausführung des Cmdlets zur Bestätigung aufzufordern.
| Typ: | SwitchParameter |
| Aliase: | cf |
| Position: | Named |
| Standardwert: | False |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-CopyToPackageShareOnDistributionPoint
Clients können ein Paket immer 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 Paket verteilen.
| Typ: | Boolean |
| Aliase: | ShareContent, 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 |
| Aliase: | ShareName |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-Description
Geben Sie eine optionale Beschreibung des Pakets an, um es zu identifizieren. Sie können maximal 128 Zeichen verwenden.
| 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: | ForceDisconnectEnabled, 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: | ForcedDisconnectDelay, DisconnectUsersFromDistributionPointsMinutes, DisconnectUserFromDistributionPointsMins, DisconnectUserFromDistributionPointsMinutes |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-DisconnectUserFromDistributionPointRetry
Diese Option ist veraltet. Es legt die ForcedDisconnectNumRetries-Eigenschaft des Treiberpakets fest.
| Typ: | UInt32 |
| Aliase: | ForceDisconnectNumRetries, 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 |
-EnableBinaryDeltaReplication
Legen Sie diesen Parameter auf $true fest, um die binäre differenzielle Replikation (BDR) zu aktivieren. Weitere Informationen finden Sie unter Grundlegende Konzepte für die Inhaltsverwaltung in Configuration Manager.
| 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
Geben Sie die ID eines zu konfigurierenden Pakets 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 konfigurierende Paketobjekt an. Verwenden Sie zum Abrufen dieses Objekts das Cmdlet Get-CMPackage .
| Typ: | IResultObject |
| Position: | 0 |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | True |
| Platzhalterzeichen akzeptieren: | False |
-Language
Geben Sie eine Sprachzeichenfolge für das Paket an. Sie können maximal 32 Zeichen in einem Format verwenden, das Sie zum Identifizieren der Sprachversion verwenden möchten. Um ein Paket zu identifizieren, verwendet Configuration Manager die Parameter Language, Manufacturer, Name und Version . Sie können beispielsweise eine englische Version und eine deutsche Version desselben Pakets verwenden.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-Manufacturer
Geben Sie den Herstellernamen für die Software an. Sie können maximal 32 Zeichen verwenden. Um ein Paket zu identifizieren, verwendet Configuration Manager die Parameter Language, Manufacturer, Name und Version .
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-MifFileName
Geben Sie den Namen der MIF-Datei (Management Information Format) an, die den Paketstatus enthält. Die Dateinamenerweiterung muss sein .mif. Verwenden Sie eine MIF-Statusdatei, um detaillierte Statusberichte zu generieren. Um eine MIF-Statusdatei zu generieren, muss Ihre Anwendung die Funktion InstallStatusMIF aufrufen. Weitere Informationen finden Sie unter Status-MIF-Funktionen.
Wenn Sie diesen Parameter festlegen und der Client die Bereitstellung ausführt, sucht der Configuration Manager-Client im %TEMP% Verzeichnis oder %windir% Verzeichnis nach der von Ihnen angegebenen MIF-Datei für den Installationsstatus. Der Installationsstatus gibt an, ob das Programm erfolgreich ausgeführt wurde.
Wenn der Client die Datei nicht findet, sucht er nach allen MIF-Dateien in diesen Verzeichnissen. Es wird ein Vergleich der Werte, die Sie für MifName, MifPublisher und MifVersion angeben, mit den In der MIF-Datei angegebenen Werten ohne Berücksichtigung der Groß-/Kleinschreibung durchgeführt. Wenn der Client eine Übereinstimmung findet, verwendet er den Status, den die MIF-Datei als Installationsstatus für das Programm angibt. Wenn keine Übereinstimmung gefunden werden kann oder Sie MifFileName nicht angeben, verwendet der Client den Programm-Exitcode, um den Installationsstatus für das Programm festzulegen. Der Exitcode 0 (null) gibt an, dass das Programm erfolgreich ausgeführt wurde. Alle anderen Werte geben anwendungsspezifische Fehlercodes an.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-MifName
Geben Sie den Namen des Pakets für den MIF-Abgleich mit bis zu 50 Zeichen an. Weitere Informationen finden Sie unter dem MifFileName-Parameter .
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-MifPublisher
Geben Sie den Softwareherausgeber des Pakets für den MIF-Abgleich mit bis zu 32 Zeichen an. Weitere Informationen finden Sie unter dem MifFileName-Parameter .
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-MifVersion
Geben Sie die Versionsnummer des Pakets für den MIF-Abgleich mit bis zu 32 Zeichen an. Weitere Informationen finden Sie unter dem MifFileName-Parameter .
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| 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 einen Paketnamen an. Sie können maximal 250 Zeichen verwenden. Um ein Paket zu identifizieren, verwendet Configuration Manager die Parameter Language, Manufacturer, Name und Version .
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-NewName
Verwenden Sie diesen Parameter, um ein Paket umzubenennen.
| 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 |
-Path
Wenn das Paket Quelldateien enthält, geben Sie den Speicherort der Dateien an. Sie können entweder einen vollständigen lokalen Pfad auf dem Standortserver oder einen Netzwerkpfad angeben. Stellen Sie sicher, dass dieser Speicherort alle Dateien und Unterverzeichnisse enthält, die das Programm ausführen muss, einschließlich aller Skripts.
| Typ: | String |
| Aliase: | PackageSourcePath |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-PersistContentInCache
Wenn der Inhalt dieses Pakets nicht aus dem Clientcache veraltet sein soll, um Platz für andere Inhalte zu schaffen, legen Sie diesen Parameter auf $true fest, um ihn im Clientcache beizubehalten.
| Typ: | Boolean |
| 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 normaler oder niedriger Priorität. Pakete mit gleicher Priorität werden in der Reihenfolge gesendet, in der sie erstellt werden.
| Typ: | Priorities |
| Aliase: | DistributionPriority |
| Zulässige Werte: | High, Normal, 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 eine Versionsnummer für die Software an. Die maximale Länge dieser Zeichenfolge beträgt 32 Zeichen. Um ein Paket zu identifizieren, verwendet Configuration Manager die Parameter Language, Manufacturer, Name und Version .
| 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