Start-CMSoftwareUpdateDeployment

Referenz

Modul:: ConfigurationManager

(Veraltet) Initiiert eine Softwareupdatebereitstellung in Configuration Manager.

Syntax

Start-CMSoftwareUpdateDeployment
     [-AcceptEula]
     [-AllowRestart <Boolean>]
     [-AllowUseMeteredNetwork <Boolean>]
     -CollectionName <String>
     [-DeploymentAvailableDay <DateTime>]
     [-DeploymentAvailableTime <DateTime>]
     [-DeploymentName <String>]
     [-DeploymentType <DeploymentType>]
     [-Description <String>]
     [-DisableOperationsManagerAlert <Boolean>]
     [-DownloadFromMicrosoftUpdate <Boolean>]
     [-EnforcementDeadline <DateTime>]
     [-EnforcementDeadlineDay <DateTime>]
     [-GenerateOperationsManagerAlert <Boolean>]
     [-GenerateSuccessAlert <Boolean>]
     -InputObject <IResultObject>
     [-PercentSuccess <Int32>]
     [-PersistOnWriteFilterDevice <Boolean>]
     [-ProtectedType <ProtectedType>]
     [-RestartServer <Boolean>]
     [-RestartWorkstation <Boolean>]
     [-SendWakeupPacket <Boolean>]
     [-SoftwareInstallation <Boolean>]
     [-TimeBasedOn <TimeType>]
     [-TimeUnit <TimeUnitType>]
     [-TimeValue <Int32>]
     [-UnprotectedType <UnprotectedType>]
     [-UseBranchCache <Boolean>]
     [-UserNotification <UserNotificationType>]
     [-VerbosityLevel <VerbosityLevelType>]
     [-DisableWildcardHandling]
     [-ForceWildcardHandling]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Start-CMSoftwareUpdateDeployment
     [-AcceptEula]
     [-AllowRestart <Boolean>]
     [-AllowUseMeteredNetwork <Boolean>]
     -CollectionName <String>
     [-DeploymentAvailableDay <DateTime>]
     [-DeploymentAvailableTime <DateTime>]
     [-DeploymentName <String>]
     [-DeploymentType <DeploymentType>]
     [-Description <String>]
     [-DisableOperationsManagerAlert <Boolean>]
     [-DownloadFromMicrosoftUpdate <Boolean>]
     [-EnforcementDeadline <DateTime>]
     [-EnforcementDeadlineDay <DateTime>]
     [-GenerateOperationsManagerAlert <Boolean>]
     [-GenerateSuccessAlert <Boolean>]
     [-PercentSuccess <Int32>]
     [-PersistOnWriteFilterDevice <Boolean>]
     [-ProtectedType <ProtectedType>]
     [-RestartServer <Boolean>]
     [-RestartWorkstation <Boolean>]
     [-SendWakeupPacket <Boolean>]
     [-SoftwareInstallation <Boolean>]
     -SoftwareUpdateName <String>
     [-TimeBasedOn <TimeType>]
     [-TimeUnit <TimeUnitType>]
     [-TimeValue <Int32>]
     [-UnprotectedType <UnprotectedType>]
     [-UseBranchCache <Boolean>]
     [-UserNotification <UserNotificationType>]
     [-VerbosityLevel <VerbosityLevelType>]
     [-DisableWildcardHandling]
     [-ForceWildcardHandling]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Start-CMSoftwareUpdateDeployment
     [-AcceptEula]
     [-AllowRestart <Boolean>]
     [-AllowUseMeteredNetwork <Boolean>]
     -CollectionName <String>
     [-DeploymentAvailableDay <DateTime>]
     [-DeploymentAvailableTime <DateTime>]
     [-DeploymentName <String>]
     [-DeploymentType <DeploymentType>]
     [-Description <String>]
     [-DisableOperationsManagerAlert <Boolean>]
     [-DownloadFromMicrosoftUpdate <Boolean>]
     [-EnforcementDeadline <DateTime>]
     [-EnforcementDeadlineDay <DateTime>]
     [-GenerateOperationsManagerAlert <Boolean>]
     [-GenerateSuccessAlert <Boolean>]
     [-PercentSuccess <Int32>]
     [-PersistOnWriteFilterDevice <Boolean>]
     [-ProtectedType <ProtectedType>]
     [-RestartServer <Boolean>]
     [-RestartWorkstation <Boolean>]
     [-SendWakeupPacket <Boolean>]
     [-SoftwareInstallation <Boolean>]
     -SoftwareUpdateId <String>
     [-TimeBasedOn <TimeType>]
     [-TimeUnit <TimeUnitType>]
     [-TimeValue <Int32>]
     [-UnprotectedType <UnprotectedType>]
     [-UseBranchCache <Boolean>]
     [-UserNotification <UserNotificationType>]
     [-VerbosityLevel <VerbosityLevelType>]
     [-DisableWildcardHandling]
     [-ForceWildcardHandling]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Start-CMSoftwareUpdateDeployment
     [-AcceptEula]
     [-AllowRestart <Boolean>]
     [-AllowUseMeteredNetwork <Boolean>]
     -CollectionName <String>
     [-DeploymentAvailableDay <DateTime>]
     [-DeploymentAvailableTime <DateTime>]
     [-DeploymentName <String>]
     [-DeploymentType <DeploymentType>]
     [-Description <String>]
     [-DisableOperationsManagerAlert <Boolean>]
     [-DownloadFromMicrosoftUpdate <Boolean>]
     [-EnforcementDeadline <DateTime>]
     [-EnforcementDeadlineDay <DateTime>]
     [-GenerateOperationsManagerAlert <Boolean>]
     [-GenerateSuccessAlert <Boolean>]
     [-PercentSuccess <Int32>]
     [-PersistOnWriteFilterDevice <Boolean>]
     [-ProtectedType <ProtectedType>]
     [-RestartServer <Boolean>]
     [-RestartWorkstation <Boolean>]
     [-SendWakeupPacket <Boolean>]
     [-SoftwareInstallation <Boolean>]
     -SoftwareUpdateGroupName <String>
     [-TimeBasedOn <TimeType>]
     [-TimeUnit <TimeUnitType>]
     [-TimeValue <Int32>]
     [-UnprotectedType <UnprotectedType>]
     [-UseBranchCache <Boolean>]
     [-UserNotification <UserNotificationType>]
     [-VerbosityLevel <VerbosityLevelType>]
     [-DisableWildcardHandling]
     [-ForceWildcardHandling]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Start-CMSoftwareUpdateDeployment
     [-AcceptEula]
     [-AllowRestart <Boolean>]
     [-AllowUseMeteredNetwork <Boolean>]
     -CollectionName <String>
     [-DeploymentAvailableDay <DateTime>]
     [-DeploymentAvailableTime <DateTime>]
     [-DeploymentName <String>]
     [-DeploymentType <DeploymentType>]
     [-Description <String>]
     [-DisableOperationsManagerAlert <Boolean>]
     [-DownloadFromMicrosoftUpdate <Boolean>]
     [-EnforcementDeadline <DateTime>]
     [-EnforcementDeadlineDay <DateTime>]
     [-GenerateOperationsManagerAlert <Boolean>]
     [-GenerateSuccessAlert <Boolean>]
     [-PercentSuccess <Int32>]
     [-PersistOnWriteFilterDevice <Boolean>]
     [-ProtectedType <ProtectedType>]
     [-RestartServer <Boolean>]
     [-RestartWorkstation <Boolean>]
     [-SendWakeupPacket <Boolean>]
     [-SoftwareInstallation <Boolean>]
     -SoftwareUpdateGroupId <String>
     [-TimeBasedOn <TimeType>]
     [-TimeUnit <TimeUnitType>]
     [-TimeValue <Int32>]
     [-UnprotectedType <UnprotectedType>]
     [-UseBranchCache <Boolean>]
     [-UserNotification <UserNotificationType>]
     [-VerbosityLevel <VerbosityLevelType>]
     [-DisableWildcardHandling]
     [-ForceWildcardHandling]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Beschreibung

Wichtig

Dieses Cmdlet ist veraltet. Verwenden Sie stattdessen New-CMSoftwareUpdateDeployment .

Das Cmdlet Start-CMSoftwareUpdateDeployment initiiert eine Softwareupdatebereitstellung.

Hinweis

Führen Sie Configuration Manager Cmdlets auf dem Configuration Manager-Websitelaufwerk aus, z. PS XYZ:\>B. . Weitere Informationen finden Sie unter Erste Schritte.

Beispiele

Beispiel 1: Starten einer erforderlichen Bereitstellung anhand des Softwareupdatenamens

PS XYZ:\> Start-CMSoftwareUpdateDeployment -SoftwareUpdateName "CT" -CollectionName "All Systems" -DeploymentName "Contoso-test" -Description "Contoso-test-deployment" -DeploymentType Required -SendWakeUpPacket $True -VerbosityLevel AllMessages -TimeBasedOn UTC -DeploymentAvailableDay 2012/10/24 -DeploymentAvailableTime 23:56 -DeploymentExpireDay 2013/10/21 -DeploymentExpireTime 11:20 -UserNotification HideAll -SoftwareInstallation $True -AllowRestart $True -RestartServer $True -RestartWorkstation $True -PersistOnWriteFilterDevice $False -GenerateSuccessAlert $True -PercentSuccess 90 -TimeValue 10 -TimeUnit Days -DisableOperationsManagerAlert $True -GenerateOperationsManagerAlert $True -ProtectedType RemoteDistributionPoint -UnprotectedType NoInstall -UseBranchCache $False -DownloadFromMicrosoftUpdate $True -AllowUseMeteredNetwork $True

Dieser Befehl startet eine erforderliche Softwareupdatebereitstellung mithilfe eines Softwareupdatenamens.

Beispiel 2: Starten einer verfügbaren Bereitstellung anhand des Softwareupdatenamens

PS XYZ:\> Start-CMSoftwareUpdateDeployment -SoftwareUpdateName "CT" -CollectionName "All Systems" -DeploymentName "Contoso-test2" -Description "Contoso-test2-deployment" -DeploymentType Available -VerbosityLevel AllMessages -TimeBasedOn UTC -DeploymentAvailableDay 2012/10/24 -DeploymentAvailableTime 23:56 -UserNotification DisplayAll -PersistOnWriteFilterDevice $False -DisableOperationsManagerAlert $True -GenerateOperationsManagerAlert $True -ProtectedType RemoteDistributionPoint -UnprotectedType NoInstall -UseBranchCache $False -DownloadFromMicrosoftUpdate $True -AllowUseMeteredNetwork $True

Dieser Befehl startet eine verfügbare Softwareupdatebereitstellung mithilfe eines Softwareupdatenamens.

Beispiel 3: Starten einer erforderlichen Bereitstellung anhand des Namens der Softwareupdategruppe

PS XYZ:\> Start-CMSoftwareUpdateDeployment -SoftwareUpdateGroupName "CTG" -CollectionName "All Systems" -DeploymentName "Contoso-test3" -Description "Contoso-test3-deployment" -DeploymentType Required -SendWakeUpPacket $True -VerbosityLevel AllMessages -TimeBasedOn UTC -DeploymentAvailableDay 2012/10/24 -DeploymentAvailableTime 23:56 -DeploymentExpireDay 2013/10/21 -DeploymentExpireTime 11:20 -UserNotification HideAll -SoftwareInstallation $True -AllowRestart $True -RestartServer $True -RestartWorkstation $True -PersistOnWriteFilterDevice $False -GenerateSuccessAlert $True -PercentSuccess 90 -TimeValue 10 -TimeUnit Days -DisableOperationsManagerAlert $True -GenerateOperationsManagerAlert $True -ProtectedType RemoteDistributionPoint -UnprotectedType NoInstall -UseBranchCache $False -DownloadFromMicrosoftUpdate $True -AllowUseMeteredNetwork $True

Dieser Befehl startet eine Softwareupdatebereitstellung mithilfe eines Sammlungsnamens und eines Eingabeobjekts.

Beispiel 4: Starten einer Bereitstellung über den Namen der Softwareupdategruppe

PS XYZ:\> Start-CMSoftwareUpdateDeployment -SoftwareUpdateGroupName "CTG" -CollectionName "All Systems" -DeploymentName "Contoso-test4" -Description "Contoso-test4-deployment" -DeploymentType Available -VerbosityLevel AllMessages -TimeBasedOn UTC -DeploymentAvailableDay 2012/10/24 -DeploymentAvailableTime 23:56 -UserNotification DisplayAll -PersistOnWriteFilterDevice $False -DisableOperationsManagerAlert $True -GenerateOperationsManagerAlert $True -ProtectedType RemoteDistributionPoint -UnprotectedType NoInstall -UseBranchCache $False -DownloadFromMicrosoftUpdate $True -AllowUseMeteredNetwork $True

Dieser Befehl startet eine Softwareupdatebereitstellung mithilfe eines Softwareupdategruppennamens.

Parameter

-AcceptEula

Einige Softwareupdates enthalten Lizenzbedingungen. Wenn Sie Softwareupdates bereitstellen, werden die Lizenzbedingungen nicht angezeigt. Fügen Sie diesen Parameter hinzu, um alle Softwareupdates unabhängig von einer zugehörigen Lizenzlaufzeit automatisch bereitzustellen.

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

-AllowRestart

Gibt an, ob nach der Installation ein Neustart zugelassen werden soll.

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

-AllowUseMeteredNetwork

Gibt an, ob Clients die Verwendung eines getakteten Netzwerks zum Herunterladen von Updates erlauben sollen.

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

-CollectionName

Gibt einen Namen einer Auflistung in Configuration Manager an. Eine Sammlung ist eine Gruppe von Clientcomputern.

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

-Confirm

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

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

-DeploymentAvailableDay

Gibt einen Tag im Format MM/TT/JJJJ an, an dem eine Softwareupdatebereitstellung verfügbar ist. Standardmäßig ist das Update sofort verfügbar.

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

-DeploymentAvailableTime

Gibt einen Zeitpunkt im HH:MM-Format an, zu dem eine Softwareupdatebereitstellung verfügbar ist. Standardmäßig ist das Update sofort verfügbar.

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

-DeploymentName

Gibt einen Namen für eine Softwareupdatebereitstellung in Configuration Manager an.

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

-DeploymentType

Gibt einen Bereitstellungstyp in Configuration Manager an.

Type:	DeploymentType
Accepted values:	Required, Available
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Description

Gibt eine Beschreibung für eine Softwareupdatebereitstellung an.

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

-DisableOperationsManagerAlert

Gibt an, ob System Center 2012 – Operations Manager-Warnungen während Softwareupdates deaktiviert werden sollen.

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

-DisableWildcardHandling

Dieser Parameter behandelt Wildcardzeichen als Literalzeichenwerte. Sie können es nicht mit ForceWildcardHandling kombinieren.

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

-DownloadFromMicrosoftUpdate

Gibt an, ob Clients Updates direkt von Microsoft Update herunterladen.

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

-EnforcementDeadline

Type:	DateTime
Aliases:	DeploymentExpireTime
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-EnforcementDeadlineDay

Type:	DateTime
Aliases:	DeploymentExpireDay
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ForceWildcardHandling

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

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

-GenerateOperationsManagerAlert

Gibt an, ob Operations Manager-Warnungen generiert werden sollen, wenn eine Softwareinstallation fehlschlägt.

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

-GenerateSuccessAlert

Gibt an, ob Warnungen generiert werden sollen, wenn eine Softwareinstallation erfolgreich ist.

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

-InputObject

Type:	IResultObject
Aliases:	SoftwareUpdate, SoftwareUpdateGroup
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-PercentSuccess

Gibt einen prozentsatz erfolgreichen Wert an.

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

-PersistOnWriteFilterDevice

Gibt an, ob ein Softwareupdate auf dem temporären Overlay installiert und änderungen später committet werden oder ob die Änderungen an einem Installationsstichtag oder in einem Wartungsfenster committet werden sollen.

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

-ProtectedType

Gibt einen geschützten Typ an.

Type:	ProtectedType
Accepted values:	NoInstall, RemoteDistributionPoint
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-RestartServer

Gibt an, ob ein Server nach einem Softwareupdate neu gestartet werden kann. Wenn Sie diesen Wert auf $True festlegen, wird verhindert, dass der Server neu gestartet wird. Wenn Sie diesen Wert auf $False festlegen, kann der Server neu gestartet werden.

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

-RestartWorkstation

Gibt an, ob eine Arbeitsstation nach einem Softwareupdate neu gestartet werden kann. Wenn Sie diesen Wert auf $True festlegen, wird verhindert, dass der Computer neu gestartet wird. Wenn Sie diesen Wert auf $False festlegen, kann der Computer neu gestartet werden.

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

-SendWakeupPacket

Gibt an, ob vor Beginn der Bereitstellung ein Aktivierungspaket an Computer gesendet werden soll. Wenn dieser Wert $True ist, aktiviert Configuration Manager einen Computer aus dem Standbymodus. 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.

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

-SoftwareInstallation

Gibt an, ob die Installation des Softwareupdates zugelassen werden soll, auch wenn die Installation außerhalb eines Wartungsfensters erfolgt.

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

-SoftwareUpdateGroupId

Gibt eine ID für eine Softwareupdategruppe an. Eine Softwareupdategruppe enthält einzelne Softwareupdates.

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

-SoftwareUpdateGroupName

Gibt einen Namen für eine Softwareupdategruppe an.

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

-SoftwareUpdateId

Gibt eine ID für ein Softwareupdate in Configuration Manager an.

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

-SoftwareUpdateName

Gibt einen Namen für ein Softwareupdate in Configuration Manager an.

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

-TimeBasedOn

Gibt an, dass Clientcomputer entweder lokale zeit oder UTC-Zeit verwenden, um die Verfügbarkeit eines Programms zu bestimmen. Die UTC-Zeit macht das Softwareupdate gleichzeitig für alle Computer verfügbar.

Type:	TimeType
Accepted values:	LocalTime, Utc
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-TimeUnit

Gibt die Zeiteinheit in Configuration Manager an. Gültige Werte sind:

Tage
Stunden
Monate
Wochen

Type:	TimeUnitType
Accepted values:	Hours, Days, Weeks, Months
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-TimeValue

Gibt einen Zeitwert in den im TimeUnit-Parameter angegebenen Einheiten an.

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

-UnprotectedType

Gibt einen nicht geschützten Typ an.

Type:	UnprotectedType
Accepted values:	NoInstall, UnprotectedDistributionPoint
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-UseBranchCache

Gibt an, ob Branch Cache als Verteilungspunkt für Updates verwendet werden soll.

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

-UserNotification

Gibt einen Benutzerbenachrichtigungstyp an.

Type:	UserNotificationType
Accepted values:	DisplayAll, DisplaySoftwareCenterOnly, HideAll
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-VerbosityLevel

Gibt den Ausführlichkeitsgrad an. Gültige Werte sind:

AllMessages
OnlyErrorMessages
OnlySuccessAndErrorMessages

Type:	VerbosityLevelType
Accepted values:	AllMessages, OnlySuccessAndErrorMessages, OnlyErrorMessages
Position:	Named
Default value:	None
Required:	False
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
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

Eingaben

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Ausgaben

System.Object