Freigeben über

Set-CMPackageDeployment

  • Referenz
Modul:
ConfigurationManager

Ändert Werte, die definieren, wie Configuration Manager ein Softwarepaket bereitstellt.

Syntax

Set-CMPackageDeployment
   [-AllowFallback <Boolean>]
   [-AllowSharedContent <Boolean>]
   [-Comment <String>]
   [-DeploymentAvailableDateTime <DateTime>]
   [-DeploymentExpireDateTime <DateTime>]
   [-EnableExpireSchedule <Boolean>]
   [-FastNetworkOption <FastNetworkOptionType>]
   -InputObject <IResultObject>
   [-PersistOnWriteFilterDevice <Boolean>]
   [-RerunBehavior <RerunBehaviorType>]
   [-RunFromSoftwareCenter <Boolean>]
   [-Schedule <IResultObject[]>]
   [-ScheduleEvent <ScheduleEventType[]>]
   [-SendWakeupPacket <Boolean>]
   [-SlowNetworkOption <SlowNetworkOptionType>]
   [-SoftwareInstallation <Boolean>]
   -StandardProgramName <String>
   [-SystemRestart <Boolean>]
   [-UseMeteredNetwork <Boolean>]
   [-UseUtcForAvailableSchedule <Boolean>]
   [-UseUtcForExpireSchedule <Boolean>]
   [-PassThru]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMPackageDeployment
   [-AllowFallback <Boolean>]
   [-AllowSharedContent <Boolean>]
   [-Comment <String>]
   [-DeploymentAvailableDateTime <DateTime>]
   [-DeploymentExpireDateTime <DateTime>]
   [-EnableExpireSchedule <Boolean>]
   [-FastNetworkOption <FastNetworkOptionType>]
   -PackageName <String>
   [-PersistOnWriteFilterDevice <Boolean>]
   [-RerunBehavior <RerunBehaviorType>]
   [-RunFromSoftwareCenter <Boolean>]
   [-Schedule <IResultObject[]>]
   [-ScheduleEvent <ScheduleEventType[]>]
   [-SendWakeupPacket <Boolean>]
   [-SlowNetworkOption <SlowNetworkOptionType>]
   [-SoftwareInstallation <Boolean>]
   -StandardProgramName <String>
   [-SystemRestart <Boolean>]
   [-UseMeteredNetwork <Boolean>]
   [-UseUtcForAvailableSchedule <Boolean>]
   [-UseUtcForExpireSchedule <Boolean>]
   [-PassThru]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMPackageDeployment
   [-AllowFallback <Boolean>]
   [-AllowSharedContent <Boolean>]
   [-Comment <String>]
   [-DeploymentAvailableDateTime <DateTime>]
   [-DeploymentExpireDateTime <DateTime>]
   [-EnableExpireSchedule <Boolean>]
   [-FastNetworkOption <FastNetworkOptionType>]
   -PackageId <String>
   [-PersistOnWriteFilterDevice <Boolean>]
   [-RerunBehavior <RerunBehaviorType>]
   [-RunFromSoftwareCenter <Boolean>]
   [-Schedule <IResultObject[]>]
   [-ScheduleEvent <ScheduleEventType[]>]
   [-SendWakeupPacket <Boolean>]
   [-SlowNetworkOption <SlowNetworkOptionType>]
   [-SoftwareInstallation <Boolean>]
   -StandardProgramName <String>
   [-SystemRestart <Boolean>]
   [-UseMeteredNetwork <Boolean>]
   [-UseUtcForAvailableSchedule <Boolean>]
   [-UseUtcForExpireSchedule <Boolean>]
   [-PassThru]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMPackageDeployment
   [-Comment <String>]
   [-DeploymentStartDateTime <DateTime>]
   -DeviceProgramName <String>
   -PackageName <String>
   [-RecurUnit <RecurUnitType>]
   [-RecurValue <Int32>]
   [-Rerun <Boolean>]
   [-UseMeteredNetwork <Boolean>]
   [-UseRecurrencePattern <Boolean>]
   [-UseUtc <Boolean>]
   [-PassThru]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMPackageDeployment
   [-Comment <String>]
   [-DeploymentStartDateTime <DateTime>]
   -DeviceProgramName <String>
   -PackageId <String>
   [-RecurUnit <RecurUnitType>]
   [-RecurValue <Int32>]
   [-Rerun <Boolean>]
   [-UseMeteredNetwork <Boolean>]
   [-UseRecurrencePattern <Boolean>]
   [-UseUtc <Boolean>]
   [-PassThru]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMPackageDeployment
   [-Comment <String>]
   [-DeploymentStartDateTime <DateTime>]
   -DeviceProgramName <String>
   -InputObject <IResultObject>
   [-RecurUnit <RecurUnitType>]
   [-RecurValue <Int32>]
   [-Rerun <Boolean>]
   [-UseMeteredNetwork <Boolean>]
   [-UseRecurrencePattern <Boolean>]
   [-UseUtc <Boolean>]
   [-PassThru]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Beschreibung

Das Cmdlet Set-CMPackageDeployment ändert Werte, die definieren, wie Configuration Manager ein Softwarepaket bereitstellt. Eine Bereitstellung umfasst eine Sammlung von Geräten oder Benutzern, ein bereitzustellende Paket und entweder einen Geräteprogrammnamen oder einen Standardprogrammnamen. Um anzugeben, welche Bereitstellung geändert werden soll, geben Sie den Sammlungsnamen, das Paket und den Programmnamen an. Sie können das Paket nach Name oder ID angeben, oder Sie können das Cmdlet Get-CMPackage verwenden, um ein Paketobjekt abzurufen.

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: Festlegen von Serieneigenschaften

PS XYZ:\> Set-CMPackageDeployment -CollectionName "All Systems" -DeviceProgramName "DPM" -PackageName "User State Migration Tool for Windows 8" -RecurUnit Hours -RecurValue 7 -UseRecurrencePattern $True

Dieser Befehl nimmt Änderungen an der Bereitstellung vor, die von der Sammlung mit dem Namen Alle Systeme, dem Geräteprogramm mit dem Namen DPM und dem Paket mit dem Namen User State Migration Tool für Windows 8 angegeben wird. Der Befehl legt den UseRecurrencePattern-Parameter auf den Wert $True fest. Der Befehl gibt eine Wiederholungseinheit von Stunden und einen Wiederholungswert von sieben an. Daher wird die Bereitstellung alle sieben Stunden wiederholt.

Beispiel 2: Festlegen des Verfügbarkeitstags und der Verfügbarkeitszeit

PS XYZ:\> Set-CMPackageDeployment -CollectionName "All Systems" -PackageName "User State Migration Tool for Windows 8" -StandardProgramName "SPM" -DeploymentAvailableDay 2012/10/18 -DeploymentAvailableTime 15:41 -UseUtcForAvailableSchedule $False

Dieser Befehl nimmt Änderungen an der Bereitstellung vor, die von der Sammlung mit dem Namen Alle Systeme, dem Paket mit dem Namen User State Migration Tool für Windows 8 und dem Standardprogramm SPM angegeben wird. Der Befehl gibt einen Tag und eine Uhrzeit an, zu dem die Bereitstellung verfügbar wird. Der Befehl gibt auch an, dass die Bereitstellung keine UTC für den Verfügbarkeitszeitplan verwendet. Der Zeitplan bezieht sich auf die lokale Zeitzone.

Parameter

-AllowFallback

{{ Fill AllowFallback Description }}

Typ:Boolean
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-AllowSharedContent

Gibt an, ob Clients freigegebene Inhalte verwenden. Wenn dieser Wert $True ist, versuchen Clients, Inhalte von anderen Clients herunterzuladen, die diesen Inhalt heruntergeladen haben. Wenn dieser Wert $False ist, versuchen Clients nicht, von anderen Clients herunterzuladen.

Typ:Boolean
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Collection

Gibt die Benutzersammlung an.

Typ:IResultObject
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-CollectionId

Gibt die ID eines Geräts oder einer Benutzersammlung an.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-CollectionName

Gibt die ID eines Geräts oder einer Benutzersammlung an.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:True

-Comment

Gibt einen Kommentar für die Bereitstellung an.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-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

-DeploymentAvailableDateTime

Gibt als DateTime-Objekt das Datum und die Uhrzeit an, zu denen die Bereitstellung verfügbar wird. Verwenden Sie das Cmdlet Get-Date, um ein DateTime-Objekt abzurufen.

Typ:DateTime
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DeploymentExpireDateTime

Gibt als DateTime-Objekt das Datum und die Uhrzeit des Ablaufs der Bereitstellung an. Verwenden Sie das Cmdlet Get-Date, um ein DateTime-Objekt abzurufen.

Typ:DateTime
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DeploymentStartDateTime

Gibt als DateTime-Objekt das Datum und die Uhrzeit des Beginns der Bereitstellung an. Verwenden Sie das Cmdlet Get-Date, um ein DateTime-Objekt abzurufen.

Typ:DateTime
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DeviceProgramName

Gibt den Namen eines Geräteprogramms an.

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
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

-EnableExpireSchedule

Gibt an, ob der Zeitplan für das Ablaufen der Bereitstellung aktiviert werden soll.

Typ:Boolean
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-FastNetworkOption

Gibt das Clientverhalten in einem schnellen Netzwerk an. Folgende Werte sind für diesen Parameter zulässig:

  • DownloadContentFromDistributionPointAndRunLocally
  • RunProgramFromDistributionPoint
Typ:FastNetworkOptionType
Zulässige Werte:RunProgramFromDistributionPoint, DownloadContentFromDistributionPointAndRunLocally
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

-InputObject

Gibt ein Paketobjekt an.

Typ:IResultObject
Aliase:Package, DeploymentSummary, Advertisement
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-PackageId

Gibt die ID eines Pakets an.

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-PackageName

Gibt den Namen eines Pakets an.

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-PassThru

Gibt das aktuelle Arbeitsobjekt zurück. Standardmäßig wird von diesem Cmdlet keine Ausgabe generiert.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-PersistOnWriteFilterDevice

Gibt an, ob Schreibfilter für eingebettete Geräte aktiviert werden sollen. Bei einem Wert von $True committet das Gerät Änderungen während eines Wartungsfensters. Diese Aktion erfordert einen Neustart. Bei einem Wert von $False speichert das Gerät Änderungen in einer Überlagerung und committet sie später.

Typ:Boolean
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-RecurUnit

Gibt eine Einheit für eine wiederkehrende Bereitstellung an. Folgende Werte sind für diesen Parameter zulässig:

  • Tage
  • Stunden
  • Minuten
Typ:RecurUnitType
Zulässige Werte:Minutes, Hours, Days
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-RecurValue

Gibt an, wie oft eine Bereitstellung wiederholt wird. Dieser Parameter hängt vom im RecurUnit-Parameter angegebenen Einheitentyp ab. Dieser Wert kann zwischen 1 und 23 betragen, wenn die Einheit Stunden ist, zwischen 1 und 31, wenn die Einheit Tage ist, oder zwischen 1 und 59, wenn die Einheit Minuten ist.

Typ:Int32
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Rerun

Gibt an, ob die Bereitstellung erneut ausgeführt wird. Wenn dieser Wert $True ist, wird die Bereitstellung für Clients erneut ausgeführt, wie im RerunBehavior-Parameter angegeben. Wenn dieser Wert $False ist, wird die Bereitstellung nicht erneut ausgeführt.

Typ:Boolean
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-RerunBehavior

Gibt an, wie eine Bereitstellung auf einem Client erneut ausgeführt wird. Folgende Werte sind für diesen Parameter zulässig:

  • AlwaysRerunProgram. Führen Sie die Ausführung wie geplant erneut aus, auch wenn die Bereitstellung erfolgreich war. Sie können diesen Wert für wiederkehrende Bereitstellungen verwenden.
  • NeverRerunDeployedProgram. Wird nicht erneut ausgeführt, auch wenn die Bereitstellung fehlgeschlagen ist oder Dateien geändert wurden.
  • RerunIfFailedPreviousAttempt. Führen Sie wie geplant erneut aus, wenn die Bereitstellung beim vorherigen Versuch fehlgeschlagen ist.
  • RerunIfSucceededOnpreviousAttempt. Führen Sie nur dann erneut aus, wenn der vorherige Versuch erfolgreich war. Sie können diesen Wert für Updates verwenden, die vom vorherigen Update abhängen.
Typ:RerunBehaviorType
Zulässige Werte:NeverRerunDeployedProgram, AlwaysRerunProgram, RerunIfFailedPreviousAttempt, RerunIfSucceededOnPreviousAttempt
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-RunFromSoftwareCenter

Gibt an, ob über das Softwarecenter ausgeführt werden soll.

Typ:Boolean
Aliase:AllowUsersRunIndependently
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Schedule

Gibt ein CMSchedule-Objekt an. Der Zeitplan gibt an, wann das Wartungsfenster auftritt. Verwenden Sie zum Erstellen eines CMSchedule-Objekts das Cmdlet New-CMSchedule .

Typ:IResultObject[]
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ScheduleEvent

Gibt ein Array von Zeitplanereignistypen an. Folgende Werte sind für diesen Parameter zulässig:

  • AsSoonAsPossible
  • Abmelden
  • LogOn
  • SendWakeUpPacket
Typ:ScheduleEventType[]
Zulässige Werte:AsSoonAsPossible, LogOn, LogOff
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-SendWakeupPacket

Gibt an, ob vor Beginn der Bereitstellung ein Aktivierungspaket an Computer gesendet werden soll. Wenn dieser Wert $True ist, reaktiviert Configuration Manager einen Computer aus dem Ruhezustand. Wenn dieser Wert $False ist, werden Computer nicht aus dem Standbymodus reaktiviert. Damit Computer reaktivieren können, müssen Sie zuerst Wake-On-LAN konfigurieren.

Typ:Boolean
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-SlowNetworkOption

Gibt an, wie Configuration Manager dieses Paket in einem langsamen Netzwerk bereitstellt. Folgende Werte sind für diesen Parameter zulässig:

  • DoNotRunProgram
  • DownloadContentFromDistributionPointAndLocally
  • RunProgramFromDistributionPoint
Typ:SlowNetworkOptionType
Zulässige Werte:DoNotRunProgram, DownloadContentFromDistributionPointAndLocally, RunProgramFromDistributionPoint
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-SoftwareInstallation

Gibt an, ob die bereitgestellte Software außerhalb von Wartungsfenstern installiert werden soll. Ein Wartungsfenster ist ein festgelegter Zeitraum, der für die Computerwartung und -updates verwendet wird. Wenn dieser Wert $True ist, installiert Configuration Manager Software gemäß dem Zeitplan, auch wenn der Zeitplan außerhalb eines Wartungsfensters liegt. Wenn dieser Wert $False ist, installiert Configuration Manager keine bereitgestellte Software außerhalb von Fenstern, sondern wartet auf ein Wartungsfenster.

Typ:Boolean
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-StandardProgramName

Gibt einen Standardprogrammnamen an.

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-SystemRestart

Gibt an, ob ein System außerhalb eines Wartungsfensters neu gestartet wird. Ein Wartungsfenster ist ein festgelegter Zeitraum, der für die Computerwartung und -updates verwendet wird. Wenn dieser Wert $True ist, erfolgt jeder erforderliche Neustart ohne Berücksichtigung von Wartungsfenstern. Wenn dieser Wert $False ist, wird der Computer nicht außerhalb eines Wartungsfensters neu gestartet.

Typ:Boolean
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-UseMeteredNetwork

{{ Fill UseMeteredNetwork Description }}

Typ:Boolean
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-UseRecurrencePattern

Gibt an, ob ein Serienmuster verwendet werden soll.

Typ:Boolean
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-UseUtc

Gibt an, ob koordinierte Weltzeit (UTC) verwendet werden soll, die auch als Greenwich Mean Time (Greenwich Mean Time) bezeichnet wird. Wenn dieser Wert $True ist, verwendet Configuration Manager utc für diese Bereitstellung. Wenn dieser Wert $False ist, verwendet Configuration Manager die Ortszeit.

Typ:Boolean
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-UseUtcForAvailableSchedule

Gibt an, ob UTC für den verfügbaren Zeitplan verwendet werden soll. Wenn dieser Wert $True ist, verwendet Configuration Manager UTC. Wenn dieser Wert $False ist, verwendet Configuration Manager die Ortszeit.

Typ:Boolean
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-UseUtcForExpireSchedule

Gibt an, ob UTC für den Ablaufzeitplan verwendet werden soll. Wenn dieser Wert $True ist, verwendet Configuration Manager UTC. Wenn dieser Wert $False ist, verwendet Configuration Manager die Ortszeit.

Typ:Boolean
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