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