New-CMWindowsServicingPlan

Erstellt einen Windows 10 Wartungsplan.

Syntax

New-CMWindowsServicingPlan
   -Name <String>
   [-Description <String>]
   -CollectionName <String>
   [-Enable <Boolean>]
   [-SendWakeupPacket <Boolean>]
   [-VerboseLevel <VerboseLevelType>]
   [-Language <String[]>]
   [-Required <String[]>]
   [-Title <String[]>]
   [-RunType <RunType>]
   [-Schedule <IResultObject>]
   [-UseUtc <Boolean>]
   [-AvailableTime <Int32>]
   [-AvailableImmediately <Boolean>]
   [-AvailableTimeUnit <TimeUnitType>]
   [-DeadlineImmediately <Boolean>]
   [-DeadlineTime <Int32>]
   [-DeadlineTimeUnit <TimeUnitType>]
   [-UserNotification <UserNotificationType>]
   [-AllowSoftwareInstallationOutsideMaintenanceWindow <Boolean>]
   [-AllowRestart <Boolean>]
   [-SuppressRestartServer <Boolean>]
   [-SuppressRestartWorkstation <Boolean>]
   [-WriteFilterHandling <Boolean>]
   [-GenerateSuccessAlert <Boolean>]
   [-SuccessPercentage <Int32>]
   [-AlertTime <Int32>]
   [-AlertTimeUnit <TimeUnitType>]
   [-DisableOperationManager <Boolean>]
   [-GenerateOperationManagerAlert <Boolean>]
   [-NoInstallOnRemote <Boolean>]
   [-NoInstallOnUnprotected <Boolean>]
   [-UseBranchCache <Boolean>]
   [-DownloadFromMicrosoftUpdate <Boolean>]
   [-AllowUseMeteredNetwork <Boolean>]
   [-DeploymentPackage <IResultObject>]
   [-DownloadFromInternet <Boolean>]
   [-Location <String>]
   [-DeploymentRing <DeploymentRing>]
   [-UpdateDeploymentWaitDay <Int32>]
   [-LanguageSelection <String[]>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-CMWindowsServicingPlan
   -Name <String>
   [-Description <String>]
   -Collection <IResultObject>
   [-Enable <Boolean>]
   [-SendWakeupPacket <Boolean>]
   [-VerboseLevel <VerboseLevelType>]
   [-Language <String[]>]
   [-Required <String[]>]
   [-Title <String[]>]
   [-RunType <RunType>]
   [-Schedule <IResultObject>]
   [-UseUtc <Boolean>]
   [-AvailableTime <Int32>]
   [-AvailableImmediately <Boolean>]
   [-AvailableTimeUnit <TimeUnitType>]
   [-DeadlineImmediately <Boolean>]
   [-DeadlineTime <Int32>]
   [-DeadlineTimeUnit <TimeUnitType>]
   [-UserNotification <UserNotificationType>]
   [-AllowSoftwareInstallationOutsideMaintenanceWindow <Boolean>]
   [-AllowRestart <Boolean>]
   [-SuppressRestartServer <Boolean>]
   [-SuppressRestartWorkstation <Boolean>]
   [-WriteFilterHandling <Boolean>]
   [-GenerateSuccessAlert <Boolean>]
   [-SuccessPercentage <Int32>]
   [-AlertTime <Int32>]
   [-AlertTimeUnit <TimeUnitType>]
   [-DisableOperationManager <Boolean>]
   [-GenerateOperationManagerAlert <Boolean>]
   [-NoInstallOnRemote <Boolean>]
   [-NoInstallOnUnprotected <Boolean>]
   [-UseBranchCache <Boolean>]
   [-DownloadFromMicrosoftUpdate <Boolean>]
   [-AllowUseMeteredNetwork <Boolean>]
   [-DeploymentPackage <IResultObject>]
   [-DownloadFromInternet <Boolean>]
   [-Location <String>]
   [-DeploymentRing <DeploymentRing>]
   [-UpdateDeploymentWaitDay <Int32>]
   [-LanguageSelection <String[]>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-CMWindowsServicingPlan
   -Name <String>
   [-Description <String>]
   -CollectionId <String>
   [-Enable <Boolean>]
   [-SendWakeupPacket <Boolean>]
   [-VerboseLevel <VerboseLevelType>]
   [-Language <String[]>]
   [-Required <String[]>]
   [-Title <String[]>]
   [-RunType <RunType>]
   [-Schedule <IResultObject>]
   [-UseUtc <Boolean>]
   [-AvailableTime <Int32>]
   [-AvailableImmediately <Boolean>]
   [-AvailableTimeUnit <TimeUnitType>]
   [-DeadlineImmediately <Boolean>]
   [-DeadlineTime <Int32>]
   [-DeadlineTimeUnit <TimeUnitType>]
   [-UserNotification <UserNotificationType>]
   [-AllowSoftwareInstallationOutsideMaintenanceWindow <Boolean>]
   [-AllowRestart <Boolean>]
   [-SuppressRestartServer <Boolean>]
   [-SuppressRestartWorkstation <Boolean>]
   [-WriteFilterHandling <Boolean>]
   [-GenerateSuccessAlert <Boolean>]
   [-SuccessPercentage <Int32>]
   [-AlertTime <Int32>]
   [-AlertTimeUnit <TimeUnitType>]
   [-DisableOperationManager <Boolean>]
   [-GenerateOperationManagerAlert <Boolean>]
   [-NoInstallOnRemote <Boolean>]
   [-NoInstallOnUnprotected <Boolean>]
   [-UseBranchCache <Boolean>]
   [-DownloadFromMicrosoftUpdate <Boolean>]
   [-AllowUseMeteredNetwork <Boolean>]
   [-DeploymentPackage <IResultObject>]
   [-DownloadFromInternet <Boolean>]
   [-Location <String>]
   [-DeploymentRing <DeploymentRing>]
   [-UpdateDeploymentWaitDay <Int32>]
   [-LanguageSelection <String[]>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Beschreibung

Das Cmdlet New-CMWindowsServicingPlan erstellt einen Windows 10 Wartungsplan.

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: Erstellen eines Wartungsplans nach Sammlungs-ID

PS XYZ:\> $Lang = ("Japanese", "English", "French")
PS XYZ:\> $Required = (">=1", "<=100")
PS XYZ:\> $Title = ("Title1", "Title2", "Title3")
PS XYZ:\> New-CMWindowsServicingPlan -Name "Test01" -CollectionId MP40001A -Description "Servicing Plan description01" -SendWakeupPacket $False -VerboseLevel AllMessages -Language $Lang -Required $Required -Title $Title -RunType DoNotRunThisRuleAutomatically -UseUtc $True -AvailableImmediately $True -DeadlineImmediately $False -UserNotification DisplayAll -AllowSoftwareInstallationOutsideMaintenanceWindow $True -AllowRestart $True -SuppressRestartServer $True -SuppressRestartWorkstation $True -DeploymentPackage (Get-CMSoftwareUpdateDeploymentPackage -Name "SUDP01")

Der erste Befehl erstellt eine Liste der Sprachen und speichert die Liste in der variablen $Lang.

Der zweite Befehl erstellt eine Liste von Suchzeichenfolgen und speichert die Liste in der variablen $Required. Diese Suchzeichenfolge sucht nach Softwareupdates, die auf mindestens einem Computer und maximal 100 Computern erforderlich sind.

Der dritte Befehl erstellt eine Liste von Softwareupdatetiteln und speichert die Liste in der $Title Variablen.

Der letzte Befehl ruft das Softwareupdatebereitstellungspaket mit dem Namen SUDP01 ab und erstellt dann einen Windows-Wartungsplan namens Test für die Zielsammlung mit der ID MP40001A. Der Befehl fügt die in $Lang gespeicherten Upgradefiltersprachen, den in $Required gespeicherten erforderlichen Filter und den in $Title gespeicherten Titelfilter für Softwareupdates hinzu.

Beispiel 2: Erstellen eines Wartungsplans anhand des Sammlungsnamens

PS XYZ:\> $LangSelect = ("Japanese", "English", "French", "German")
PS XYZ:\> New-CMWindowsServicingPlan -Name "Test02" -CollectionName "ColName02" -DeploymentPackage (Get-CMSoftwareUpdateDeploymentPackage -Name "SUP02") -WriteFilterHandling $True -GenerateSuccessAlert $True -SuccessPercentage $True -AlertTime 10 -AlertTimeUnit Days -DisableOperationManager $True -GenerateOperationManagerAlert $True -NoInstallOnRemote $True -NoInstallOnUnprotected $True -UseBranchCache $True -DownloadFromMicrosoftUpdate $True -AllowUseMeteredNetwork $True -DownloadFromInternet $True -Location "\\TestSevr\WSUSTemp" -DeploymentRing Cbb -UpdateDeploymentWaitDay 20 -LanguageSelection $LangSelect

Der erste Befehl erstellt eine Liste der Sprachen für die Sprachauswahl und speichert die Liste in der variablen $LangSelect.

Der zweite Befehl ruft das Softwareupdatebereitstellungspaket mit dem Namen SUP02 ab und erstellt dann einen Windows-Wartungsplan namens Test02 für die Zielsammlung mit dem Namen ColName02. Der Befehl fügt die sprachenauswahl in $LangSelect.

Parameter

-AlertTime

Gibt einen ganzzahligen Offset aus einem Updatebereitstellungsstichtag an. Die Regel verwendet diesen Wert, um anzugeben, wann die Regel Warnungen generiert. Geben Sie mithilfe des Parameters AlertTimeUnit eine Zeiteinheit an.

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

-AlertTimeUnit

Gibt eine Zeiteinheit für den AlertTime-Parameter an. Gültige Werte sind:

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

-AllowRestart

Gibt an, ob ein Systemneustart außerhalb definierter Wartungsfenster ausgeführt werden darf, wenn der Installationsstichtag erreicht ist.

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

-AllowSoftwareInstallationOutsideMaintenanceWindow

Gibt an, ob die Softwareinstallation außerhalb definierter Wartungsfenster ausgeführt werden darf, wenn der Installationsstichtag erreicht ist.

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

-AllowUseMeteredNetwork

Gibt an, ob Clients das Herunterladen von Inhalten über eine getaktete Internetverbindung nach Ablauf des Stichtags ermöglichen sollen, was zusätzliche Kosten verursachen kann.

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

-AvailableImmediately

Gibt an, ob Softwareupdates nach der Ausführung der Regel so bald wie möglich installiert werden können.

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

-AvailableTime

Geben Sie an, wann Softwareupdates verfügbar sind.

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

-AvailableTimeUnit

Gibt den Zeiteinheitstyp für die verfügbare Softwarezeit an. Gültige Werte sind:

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

-Collection

Gibt das Zielgerätesammlungsobjekt an, das für den Wartungsplan verwendet werden soll. Verwenden Sie zum Abrufen eines Gerätesammlungsobjekts die Cmdlets Get-CMCollection oder Get-CMDeviceCollection .

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

-CollectionId

Gibt die ID der Zielgerätesammlung an, die für den Wartungsplan verwendet werden soll.

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

-CollectionName

Gibt den Namen der Zielgerätesammlung an, die für den Wartungsplan verwendet werden soll.

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

-DeadlineImmediately

Gibt an, ob erforderliche Softwareupdates so bald wie möglich installiert werden, wenn der Stichtag erreicht ist.

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

-DeadlineTime

Gibt die Anzahl der Zeiteinheiten für den Stichtag an.

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

-DeadlineTimeUnit

Gibt den Zeiteinheitstyp für den Stichtag an. Gültige Werte sind:

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

-DeploymentPackage

Gibt ein Softwareupdatebereitstellungspaket an. Verwenden Sie zum Abrufen eines Softwareupdatebereitstellungspakets das Cmdlet Get-CMSoftwareUpdateDeploymentPackage .

Type:IResultObject
Aliases:InputObject
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DeploymentRing

Gibt den Windows-Bereitschaftsstatus an, auf den der Wartungsplan angewendet werden soll. Gültige Werte sind:

  • CB
  • Freigabe
  • BusinessMainstream
  • Cbb
  • Ltsb
Type:DeploymentRing
Accepted values:CB, Release, BusinessMainstream, Cbb, Ltsb
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Description

Gibt eine Beschreibung für den Wartungsplan an.

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

-DisableOperationManager

Gibt an, ob System Center 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

-DownloadFromInternet

Gibt an, ob Softwareupdates aus dem Internet heruntergeladen werden sollen.

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

-DownloadFromMicrosoftUpdate

Gibt an, ob Computer Inhalte von Microsoft Update herunterladen, wenn die Softwareupdates auf einem bevorzugten Verteilungspunkt oder Remoteverteilungspunkt nicht verfügbar sind.

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

-Enable

Gibt an, ob der Wartungsplan aktiviert ist.

Type:Boolean
Aliases:Enabled, EnableDeployment
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-GenerateOperationManagerAlert

Gibt an, ob Während eines Softwareupdates Operations Manager-Warnungen generiert werden sollen.

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

-GenerateSuccessAlert

Gibt an, ob eine Warnung für eine erfolgreiche Bereitstellung generiert werden soll.

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

-Language

Gibt ein Array von Sprachen an, die zum Filtern von Softwareupgrades verwendet werden, die dem Serviceplan hinzugefügt werden.

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

-LanguageSelection

Gibt ein Array von Sprachen als Zeichenfolgen an. Computer laden Softwareupdates herunter, die in den angegebenen Sprachen verfügbar sind, zusätzlich zu nicht sprachspezifischen Updates.

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

-Location

Gibt einen Netzwerkspeicherort an, an dem sich die heruntergeladenen Updates befinden.

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

-Name

Gibt einen Namen für den Wartungsplan an. Der Name muss eindeutig sein, dabei helfen, das Ziel der Regel zu beschreiben und ihn von anderen auf der Configuration Manager Website zu identifizieren.

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

-NoInstallOnRemote

Gibt an, ob die Installation von Updates auf Remotesystemen zugelassen werden soll. Wenn Sie den Wert $True angeben, sich der Client innerhalb einer langsamen oder unzuverlässigen Netzwerkgrenze befindet oder wenn der Client einen Fallbackquellspeicherort für Inhalte verwendet, installiert Configuration Manager keine Softwareupdates. Wenn Sie den Wert $False angeben, wird die Installation fortgesetzt.

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

-NoInstallOnUnprotected

Gibt an, ob die Installation von Updates auf ungeschützten Systemen zugelassen werden soll. Wenn Sie den Wert $True angeben und Softwareupdates auf bevorzugten Verteilungspunkten nicht verfügbar sind, lädt Configuration Manager keine Softwareupdates herunter und installiert sie nicht. Wenn Sie den Wert $False angeben, wird die Installation fortgesetzt.

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

-Required

Gibt ein Array von Suchzeichenfolgen an, die zum Filtern von Softwareupgrades verwendet werden, die dem Serviceplan hinzugefügt werden.

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

-RunType

Gibt den Modus an, in dem ein Update ausgeführt wird. Gültige Werte sind:

  • DoNotRunThisRuleAutomatisch
  • RunTheRuleAfterAnySoftwareUpdatePointSynchronization
  • RunTheRuleOnSchedule
Type:RunType
Accepted values:DoNotRunThisRuleAutomatically, RunTheRuleAfterAnySoftwareUpdatePointSynchronization, RunTheRuleOnSchedule
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Schedule

Gibt den Stichtag (ab verfügbarer Bereitstellungszeit) an. Verwenden Sie zum Erstellen eines Zeitplans das Cmdlet New-CMSchedule .

Type:IResultObject
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

-SuccessPercentage

Gibt einen Prozentsatz für die Clientkonformität als ganze Zahl von 0 bis 99 an. Wenn die Konformität unter diesen Prozentsatz fällt, erzeugt Configuration Manager optionale Warnungen.

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

-SuppressRestartServer

Gibt an, ob ein Systemneustart auf Servern unterdrückt wird, wenn ein Softwareupdate einen Systemneustart erfordert, um den Installationsvorgang abzuschließen.

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

-SuppressRestartWorkstation

Gibt an, ob ein Systemneustart auf Arbeitsstationen unterdrückt wird, wenn ein Softwareupdate einen Systemneustart erfordert, um den Installationsvorgang abzuschließen.

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

-Title

Gibt ein Array von Suchzeichenfolgen an, die zum Filtern von Softwareupdatetiteln verwendet werden, die dem Dienstplan hinzugefügt werden.

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

-UpdateDeploymentWaitDay

Gibt die Anzahl der Tage an, die gewartet werden müssen, nachdem Microsoft ein neues Upgrade veröffentlicht hat, bevor die Bereitstellung in Ihrer Umgebung erfolgt.

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

-UseBranchCache

Gibt an, ob ein Branchcache verwendet werden soll. Wenn Sie den Wert $True angeben, teilen Clients Inhalte im gleichen Subnetz.

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

-UserNotification

Gibt das Benachrichtigungsverhalten der visuellen Benutzeroberfläche an. Gültige Werte sind:

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

-UseUtc

Gibt an, ob der Zeitplan für diese Bereitstellung basierend auf der koordinierten Weltzeit (UTC) ausgewertet wird.

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

-VerboseLevel

Gibt die Detailebene an, die Clients für Bereitstellungen melden sollen, die von dieser Regel erstellt werden. Gültige Werte sind:

  • AllMessages
  • OnlyErrorMessages
  • OnlySuccessAndErrorMessages
Type:VerboseLevelType
Accepted values:OnlyErrorMessages, OnlySuccessAndErrorMessages, AllMessages
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

-WriteFilterHandling

Gibt an, ob Änderungen zum Stichtag oder während eines Wartungsfensters committet werden (neustarts erforderlich). Wenn auf $False festgelegt ist, wird der Inhalt auf die Überlagerung angewendet und später committet.

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

Eingaben

None

Ausgaben

System.Object