New-CMSoftwareUpdateAutoDeploymentRule
Erstellen Sie eine automatische Bereitstellungsregel (ADR) für Softwareupdates.
Syntax
New-CMSoftwareUpdateAutoDeploymentRule
[-AddToExistingSoftwareUpdateGroup <Boolean>]
[-AlertTime <Int32>]
[-AlertTimeUnit <TimeUnitType>]
[-AllowRestart <Boolean>]
[-AllowSoftwareInstallationOutsideMaintenanceWindow <Boolean>]
[-AllowUseMeteredNetwork <Boolean>]
[-Architecture <ArchitectureType[]>]
[-ArticleId <String[]>]
[-AvailableImmediately <Boolean>]
[-AvailableTime <Int32>]
[-AvailableTimeUnit <TimeUnitType>]
[-BulletinId <String[]>]
[-CMTag <CMTagTypes[]>]
-Collection <IResultObject>
[-ContentSize <String[]>]
[-CustomSeverity <SeverityType[]>]
[-DateReleasedOrRevised <DateReleasedOrRevisedType>]
[-DeadlineImmediately <Boolean>]
[-DeadlineTime <Int32>]
[-DeadlineTimeUnit <TimeUnitType>]
[-DeploymentPackage <IResultObject>]
[-DeploymentPackageName <String>]
[-DeploymentRing <DeploymentRing>]
[-DeployWithoutLicense <Boolean>]
[-Description <String>]
[-DisableOperationManager <Boolean>]
[-DownloadFromInternet <Boolean>]
[-DownloadFromMicrosoftUpdate <Boolean>]
[-Enable <Boolean>]
[-EnabledAfterCreate <Boolean>]
[-GenerateFailureAlert <Boolean>]
[-GenerateOperationManagerAlert <Boolean>]
[-GenerateSuccessAlert <Boolean>]
[-IsServicingPlan]
[-Language <String[]>]
[-LanguageSelection <String[]>]
[-Location <String>]
[-MicrosoftAsVendor <Boolean>]
-Name <String>
[-NoInstallOnRemote <Boolean>]
[-NoInstallOnUnprotected <Boolean>]
[-O365LanguageSelection <String[]>]
[-Product <String[]>]
[-Required <String[]>]
[-RequirePostRebootFullScan <Boolean>]
[-RunType <RunType>]
[-Schedule <IResultObject>]
[-SendWakeupPacket <Boolean>]
[-Severity <SeverityType[]>]
[-SoftDeadlineEnabled <Boolean>]
[-SuccessPercentage <Int32>]
[-Superseded <Boolean>]
[-SuppressRestartServer <Boolean>]
[-SuppressRestartWorkstation <Boolean>]
[-Title <String[]>]
[-UpdateClassification <String[]>]
[-UpdateDeploymentWaitDay <Int32>]
[-UpdateDescription <String[]>]
[-UseBranchCache <Boolean>]
[-UserNotification <UserNotificationType>]
[-UseUtc <Boolean>]
[-Vendor <String[]>]
[-VerboseLevel <VerboseLevelType>]
[-WriteFilterHandling <Boolean>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-CMSoftwareUpdateAutoDeploymentRule
[-AddToExistingSoftwareUpdateGroup <Boolean>]
[-AlertTime <Int32>]
[-AlertTimeUnit <TimeUnitType>]
[-AllowRestart <Boolean>]
[-AllowSoftwareInstallationOutsideMaintenanceWindow <Boolean>]
[-AllowUseMeteredNetwork <Boolean>]
[-Architecture <ArchitectureType[]>]
[-ArticleId <String[]>]
[-AvailableImmediately <Boolean>]
[-AvailableTime <Int32>]
[-AvailableTimeUnit <TimeUnitType>]
[-BulletinId <String[]>]
[-CMTag <CMTagTypes[]>]
-CollectionId <String>
[-ContentSize <String[]>]
[-CustomSeverity <SeverityType[]>]
[-DateReleasedOrRevised <DateReleasedOrRevisedType>]
[-DeadlineImmediately <Boolean>]
[-DeadlineTime <Int32>]
[-DeadlineTimeUnit <TimeUnitType>]
[-DeploymentPackage <IResultObject>]
[-DeploymentPackageName <String>]
[-DeploymentRing <DeploymentRing>]
[-DeployWithoutLicense <Boolean>]
[-Description <String>]
[-DisableOperationManager <Boolean>]
[-DownloadFromInternet <Boolean>]
[-DownloadFromMicrosoftUpdate <Boolean>]
[-Enable <Boolean>]
[-EnabledAfterCreate <Boolean>]
[-GenerateFailureAlert <Boolean>]
[-GenerateOperationManagerAlert <Boolean>]
[-GenerateSuccessAlert <Boolean>]
[-IsServicingPlan]
[-Language <String[]>]
[-LanguageSelection <String[]>]
[-Location <String>]
[-MicrosoftAsVendor <Boolean>]
-Name <String>
[-NoInstallOnRemote <Boolean>]
[-NoInstallOnUnprotected <Boolean>]
[-O365LanguageSelection <String[]>]
[-Product <String[]>]
[-Required <String[]>]
[-RequirePostRebootFullScan <Boolean>]
[-RunType <RunType>]
[-Schedule <IResultObject>]
[-SendWakeupPacket <Boolean>]
[-Severity <SeverityType[]>]
[-SoftDeadlineEnabled <Boolean>]
[-SuccessPercentage <Int32>]
[-Superseded <Boolean>]
[-SuppressRestartServer <Boolean>]
[-SuppressRestartWorkstation <Boolean>]
[-Title <String[]>]
[-UpdateClassification <String[]>]
[-UpdateDeploymentWaitDay <Int32>]
[-UpdateDescription <String[]>]
[-UseBranchCache <Boolean>]
[-UserNotification <UserNotificationType>]
[-UseUtc <Boolean>]
[-Vendor <String[]>]
[-VerboseLevel <VerboseLevelType>]
[-WriteFilterHandling <Boolean>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-CMSoftwareUpdateAutoDeploymentRule
[-AddToExistingSoftwareUpdateGroup <Boolean>]
[-AlertTime <Int32>]
[-AlertTimeUnit <TimeUnitType>]
[-AllowRestart <Boolean>]
[-AllowSoftwareInstallationOutsideMaintenanceWindow <Boolean>]
[-AllowUseMeteredNetwork <Boolean>]
[-Architecture <ArchitectureType[]>]
[-ArticleId <String[]>]
[-AvailableImmediately <Boolean>]
[-AvailableTime <Int32>]
[-AvailableTimeUnit <TimeUnitType>]
[-BulletinId <String[]>]
[-CMTag <CMTagTypes[]>]
-CollectionName <String>
[-ContentSize <String[]>]
[-CustomSeverity <SeverityType[]>]
[-DateReleasedOrRevised <DateReleasedOrRevisedType>]
[-DeadlineImmediately <Boolean>]
[-DeadlineTime <Int32>]
[-DeadlineTimeUnit <TimeUnitType>]
[-DeploymentPackage <IResultObject>]
[-DeploymentPackageName <String>]
[-DeploymentRing <DeploymentRing>]
[-DeployWithoutLicense <Boolean>]
[-Description <String>]
[-DisableOperationManager <Boolean>]
[-DownloadFromInternet <Boolean>]
[-DownloadFromMicrosoftUpdate <Boolean>]
[-Enable <Boolean>]
[-EnabledAfterCreate <Boolean>]
[-GenerateFailureAlert <Boolean>]
[-GenerateOperationManagerAlert <Boolean>]
[-GenerateSuccessAlert <Boolean>]
[-IsServicingPlan]
[-Language <String[]>]
[-LanguageSelection <String[]>]
[-Location <String>]
[-MicrosoftAsVendor <Boolean>]
-Name <String>
[-NoInstallOnRemote <Boolean>]
[-NoInstallOnUnprotected <Boolean>]
[-O365LanguageSelection <String[]>]
[-Product <String[]>]
[-Required <String[]>]
[-RequirePostRebootFullScan <Boolean>]
[-RunType <RunType>]
[-Schedule <IResultObject>]
[-SendWakeupPacket <Boolean>]
[-Severity <SeverityType[]>]
[-SoftDeadlineEnabled <Boolean>]
[-SuccessPercentage <Int32>]
[-Superseded <Boolean>]
[-SuppressRestartServer <Boolean>]
[-SuppressRestartWorkstation <Boolean>]
[-Title <String[]>]
[-UpdateClassification <String[]>]
[-UpdateDeploymentWaitDay <Int32>]
[-UpdateDescription <String[]>]
[-UseBranchCache <Boolean>]
[-UserNotification <UserNotificationType>]
[-UseUtc <Boolean>]
[-Vendor <String[]>]
[-VerboseLevel <VerboseLevelType>]
[-WriteFilterHandling <Boolean>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Beschreibung
Das Cmdlet New-CMSoftwareUpdateAutoDeploymentRule erstellt eine automatische Bereitstellungsregel (ADR) für Softwareupdates. Wenn eine Regel ausgeführt wird, fügt Configuration Manager einer Softwareupdategruppe Updates hinzu, die für die Regel geeignet sind. Der Configuration Manager-Server lädt Inhaltsdateien herunter, kopiert sie auf Verteilungspunkte und aktualisiert dann Clientcomputer. Weitere Informationen finden Sie unter Automatisches Bereitstellen von Softwareupdates.
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: Erstellen einer einfachen ADR
Dieser Befehl erstellt eine Bereitstellungsregel namens DeploymentRule07 für die Sammlung mit dem Namen Desktops und das BereitstellungspaketUpdates123. Die Regel stellt Updates mit einer Artikel-ID bereit, die 117 enthält.
New-CMSoftwareUpdateAutoDeploymentRule -CollectionName "Desktops" -DeploymentPackageName "Updates123" -Name "DeploymentRule07" -ArticleId "117"Beispiel 2: Erstellen einer ADR, die einen Zeitplan und andere Eigenschaften verwendet
In diesem Beispiel wird eine Regel für die automatische Bereitstellung erstellt, die einen definierten Zeitplan verwendet. Die Bereitstellung erfolgt gemäß dem Zeitplan.
Der erste Befehl erstellt einen Zeitplan für Mittwoch und speichert das Schedule-Objekt in der variablen $Schedule . Weitere Informationen finden Sie unter New-CMSchedule.
Der zweite Befehl erstellt eine automatische Bereitstellungsregel für Updates, die das in der Variablen gespeicherte Schedule-Objekt verwendet. Dieser Befehl gibt Werte für viele Parameter an.
$Schedule = New-CMSchedule -DayOfWeek Wednesday
New-CMSoftwareUpdateAutoDeploymentRule -CollectionName "Laptops" -DeploymentPackageName "Updates235" -Name "DeploymentRule22" -AddToExistingSoftwareUpdateGroup $False -AlertTime 4 -AlertTimeUnit Weeks -AllowRestart $True -AllowSoftwareInstallationOutsideMaintenanceWindow $True -AllowUseMeteredNetwork $True -ArticleId "test" -AvailableImmediately $False -AvailableTime 5 -AvailableTimeUnit Months -CustomSeverity Critical -DateReleasedOrRevised Last1day -DeadlineImmediately $False -DeadlineTime $True -DeadlineTimeUnit Hours -DeployWithoutLicense $True -Description "Standard updates for our laptop systems." -DisableOperationManager $True -DownloadFromInternet $False -DownloadFromMicrosoftUpdate $True -EnabledAfterCreate $False -GenerateOperationManagerAlert $True -GenerateSuccessAlert $True -Location "\\k\aS_O15_Client_Dev_1" -NoInstallOnRemote $False -NoInstallOnUnprotected $True -RunType RunTheRuleOnSchedule -Schedule $Schedule -SendWakeUpPacket $True -SuccessPercent 99 -Superseded $True -SuppressRestartServer $True -SuppressRestartWorkstation $True -UpdateClassification "Critical Updates" -UseBranchCache $False -UserNotification DisplayAll -UseUtc $True -VerboseLevel AllMessages -WriteFilterHandling $TrueBeispiel 3: Erstellen eines ADR für mehrere Sprachen
In diesem Beispiel wird eine ADR erstellt, die die Sprachkriterien für drei Sprachen hinzufügt: Englisch, Ungarisch und Chinesisch (vereinfacht, VR China). Außerdem werden diese Sprachen für die Windows- und Office 365-Updatebinärdateien zum Herunterladen hinzugefügt. Diese Beispielregel ist standardmäßig deaktiviert.
New-CMSoftwareUpdateAutoDeploymentRule -Name "Multi-language ADR" -CollectionId "XYZ0003F" -Language "English","Hungarian","Chinese (Simplified, PRC)" -Enable $false -EnabledAfterCreate $false -RunType DoNotRunThisRuleAutomatically -LanguageSelection "English","Hungarian","Chinese (Simplified, PRC)" -O365LanguageSelection "English (United States)","Hungarian (Hungary)","Chinese (Simplified, PRC)"Parameter
-AddToExistingSoftwareUpdateGroup
Gibt an, ob die Regel einer vorhandenen Softwareupdategruppe hinzugefügt wird.
- Wenn dieser Wert ist
$True, fügt sie jedes Mal, wenn die Regel ausgeführt wird und neue Updates findet, einer vorhandenen Updategruppe hinzu. - Wenn dieser Wert ist
$False, wird eine neue Updategruppe erstellt.
Geben Sie die vorhandene Updategruppe an, oder weisen Sie einen Namen für die neue Updategruppe zu, indem Sie den Parameter -DeploymentPackageName verwenden.
| Typ: | Boolean |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-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.
| Typ: | Int32 |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-AlertTimeUnit
Gibt eine Zeiteinheit für den Parameter -AlertTime an.
| Typ: | TimeUnitType |
| Zulässige Werte: | Hours, Days, Weeks, Months |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-AllowRestart
Gibt an, ob ein Neustart eines Computers zugelassen werden soll, wenn die Updatebereitstellung außerhalb eines Wartungsfensters erfolgt. Ein Wartungsfenster ist ein festgelegter Zeitraum, der für die Computerwartung und -updates verwendet wird.
- Wenn dieser Wert ist
$True, startet Configuration Manager den Computer bei Bedarf neu, um das Update abzuschließen. - Wenn dieser Wert ist
$False, startet Configuration Manager den Computer nicht neu.
| Typ: | Boolean |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-AllowSoftwareInstallationOutsideMaintenanceWindow
Gibt an, ob die Updatebereitstellung auch dann erfolgt, wenn sie außerhalb eines Wartungsfensters geplant ist. Ein Wartungsfenster ist ein festgelegter Zeitraum, der für die Computerwartung und -updates verwendet wird.
- Wenn dieser Wert ist, stellt
$TrueConfiguration Manager das Update bereit, auch wenn die geplante Zeit außerhalb des Dienstfensters liegt. - Wenn dieser Wert ist
$False, stellt Configuration Manager das Update nicht außerhalb des Dienstfensters bereit. Sie wartet, bis sie in einem Dienstfenster bereitgestellt werden kann.
| Typ: | Boolean |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | 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.
| Typ: | Boolean |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-Architecture
Verwenden Sie diesen Parameter, um den Eigenschaftenfilter Architektur auf der Seite Softwareupdates der ADR-Eigenschaften festzulegen.
| Typ: | ArchitectureType[] |
| Aliase: | Architectures |
| Zulässige Werte: | Arm64, Itanium, X64, X86 |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-ArticleId
Gibt ein Array von Kriterien als Zeichenfolgen für Softwareupdates an. Die Regel fügt der Softwareupdategruppe Softwareupdates mit Artikel-IDs hinzu, die die angegebenen Kriterien erfüllen.
| Typ: | String[] |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-AvailableImmediately
Gibt an, ob diese Regel Updates bereitstellt, sobald die Updates verfügbar sind. Wenn Sie den Wert $Falseauswählen, verwenden Sie die Parameter -AvailableTime und -AvailableTimeUnit , um anzugeben, wie lange die Regel ausgeführt wird, um die Updates bereitzustellen.
| Typ: | Boolean |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-AvailableTime
Gibt einen Zeitraum als ganze Zahl an. Configuration Manager stellt die Updates so lange bereit, nachdem die Regel ausgeführt wurde. Geben Sie mithilfe des Parameters -AvailableTimeUnit eine Zeiteinheit an.
| Typ: | Int32 |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-AvailableTimeUnit
Gibt eine Zeiteinheit für den Parameter -AvailableTime an.
| Typ: | TimeUnitType |
| Zulässige Werte: | Hours, Days, Weeks, Months |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-BulletinId
Gibt ein Array von Kriterien als Zeichenfolgen für Softwareupdates an. Die Regel fügt der Softwareupdategruppe Softwareupdates hinzu, die über Bulletin-IDs verfügen, die die angegebenen Kriterien erfüllen.
| Typ: | String[] |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-CMTag
Diese Eigenschaft ist für die zukünftige Verwendung reserviert.
| Typ: | CMTagTypes[] |
| Zulässige Werte: | None, UUP |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-Collection
Geben Sie ein Auflistungsobjekt als Ziel für die automatische Bereitstellungsregel an.
| Typ: | IResultObject |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-CollectionId
Geben Sie eine Sammlungs-ID als Ziel für die automatische Bereitstellungsregel an.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-CollectionName
Geben Sie einen Sammlungsnamen als Ziel für die automatische Bereitstellungsregel an.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | True |
| 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 |
-ContentSize
Verwenden Sie diesen Parameter, um den Eigenschaftenfilter Inhaltsgröße (KB) auf der Seite Softwareupdates der ADR-Eigenschaften festzulegen.
| Typ: | String[] |
| Aliase: | ContentSizes |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-CustomSeverity
Gibt ein Array von benutzerdefinierten Schweregradtypen für Softwareupdates an. Die Regel fügt der Softwareupdategruppe Softwareupdates mit benutzerdefinierten Schweregraden hinzu, die die angegebenen Kriterien erfüllen.
| Typ: | SeverityType[] |
| Zulässige Werte: | None, Low, Moderate, Important, Critical |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-DateReleasedOrRevised
Gibt ein Datum an, das für Softwareupdates veröffentlicht oder überarbeitet wurde. Die Regel fügt der Softwareupdategruppe Softwareupdates hinzu, die ein Datum aufweisen, das die angegebenen Kriterien erfüllt.
| Typ: | DateReleasedOrRevisedType |
| Zulässige Werte: | Any, Last1Hour, LastHour, Last2Hours, Last3Hours, Last4Hours, Last8Hours, Last12Hours, Last16Hours, Last20Hours, Last1Day, LastDay, Last2Days, Last3Days, Last4Days, Last5Days, Last6Days, Last7Days, Last14Days, Last21Days, Last28Days, LastMonth, Last1Month, Last2Months, Last3Months, Last4Months, Last5Months, Last6Months, Last7Months, Last8Months, Last9Months, Last10Months, Last11Months, Last1Year, LastYear, Last12Months |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-DeadlineImmediately
Gibt an, ob die Frist gesetzt werden soll, sobald die Regel ausgeführt wird. Wenn Sie den Wert $Falseangeben, verwenden Sie die Parameter -DeadlineTime und -DeadlineTimeUnit , um anzugeben, wie lange die Regel ausgeführt wird, um den Stichtag festzulegen. Nach Ablauf der Frist installiert Configuration Manager die erforderlichen Updates.
| Typ: | Boolean |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-DeadlineTime
Gibt einen Zeitraum als ganze Zahl an. Die Frist für Updates ist so lange, nachdem die Regel ausgeführt wurde. Geben Sie mithilfe des Parameters -DeadlineTimeUnit eine Zeiteinheit an.
| Typ: | Int32 |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-DeadlineTimeUnit
Gibt eine Zeiteinheit für den Parameter -DeadlineTime an.
| Typ: | TimeUnitType |
| Zulässige Werte: | Hours, Days, Weeks, Months |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-DeploymentPackage
Verwenden Sie diesen Parameter, um ein Objekt für das Bereitstellungspaket anzugeben, das mit dieser automatischen Bereitstellungsregel verwendet werden soll. Um kein Paket zu benötigen, legen Sie den Wert auf fest $null.
| Typ: | IResultObject |
| Aliase: | InputObject |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | True |
| Platzhalterzeichen akzeptieren: | False |
-DeploymentPackageName
Geben Sie den Namen des Bereitstellungspakets an, das mit dieser automatischen Bereitstellungsregel verwendet werden soll. Um kein Paket zu benötigen, legen Sie den Wert auf fest $null.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-DeploymentRing
| Typ: | DeploymentRing |
| Zulässige Werte: | CB, Release, BusinessMainstream, Cbb, Ltsb |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-DeployWithoutLicense
Gibt an, ob die Regel Updates ohne Lizenzen bereitstellt.
- Wenn Sie den Wert
$Trueangeben, stellt Configuration Manager alle Updates für diese Regel bereit und genehmigt alle Lizenzverträge. - Wenn dieser Wert ist
$False, stellt Configuration Manager nur Updates bereit, die keine Lizenz enthalten oder für die der Lizenzvertrag genehmigt wurde.
| Typ: | Boolean |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-Description
Gibt eine Beschreibung für die Automatische Bereitstellungsregel für Softwareupdates an.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-DisableOperationManager
Gibt an, ob System Center Operations Manager-Warnungen während Softwareupdates deaktiviert werden sollen.
| Typ: | Boolean |
| 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 |
-DownloadFromInternet
Gibt an, ob Computer Softwareupdates aus dem Internet herunterladen. Wenn Sie den Wert angeben, geben Sie mit dem $FalseParameter -Location einen alternativen Speicherort an, an dem Computer Updates herunterladen können.
| Typ: | Boolean |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-DownloadFromMicrosoftUpdate
Gibt an, ob Computer Inhalte von Microsoft Update herunterladen, wenn diese Inhalte auf einem bevorzugten Verteilungspunkt des Remoteverteilungspunkts nicht verfügbar sind.
| Typ: | Boolean |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-Enable
Geben Sie an, ob die automatische Bereitstellungsregel aktiviert ist, nachdem Sie sie erstellt haben.
| Typ: | Boolean |
| Aliase: | Enabled, EnableDeployment |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-EnabledAfterCreate
Gibt an, ob die Softwarebereitstellung für die zugeordnete Softwareupdategruppe aktiviert werden soll, nachdem diese Regel ausgeführt wurde. Wenn dieser Wert ist $False, stellen Sie die Softwareupdategruppe manuell bereit.
| Typ: | Boolean |
| Aliase: | EnableAfterCreate |
| 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 |
-GenerateFailureAlert
Wenn die Regel fehlschlägt, erstellen Sie eine Configuration Manager-Warnung.
| Typ: | Boolean |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-GenerateOperationManagerAlert
Gibt an, ob Operations Manager-Warnungen während eines Softwareupdates generiert werden sollen.
| Typ: | Boolean |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-GenerateSuccessAlert
Gibt an, ob eine Warnung für eine erfolgreiche Bereitstellung generiert werden soll.
| Typ: | Boolean |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-IsServicingPlan
| Typ: | SwitchParameter |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-Language
Geben Sie ein Zeichenfolgenarray von Sprachkriterien für Softwareupdates an. Die Regel fügt der Softwareupdategruppe Softwareupdates hinzu, die Über Sprachen verfügen, die die angegebenen Kriterien erfüllen.
Verwenden Sie das In der Konsole angezeigte Format der Sprache. Zum Beispiel:
EnglishHungarianChinese (Simplified, PRC)
Das Format für das Zeichenfolgenarray lautet: "English","Hungarian","Chinese (Simplified, PRC)"
Tipp
Wenn Sie dieses Cmdlet auf einem Computer ausführen, auf dem Windows über eine lokalisierte Benutzeroberfläche verfügt, können sich die Sprachnamen unterscheiden. Beispielsweise wird in der englischen Version von Windows "Dänisch" verwendet, in der dänischen Version von Windows hingegen "Dansk".
| Typ: | String[] |
| Aliase: | Languages, UpdateLocales, UpdateLocale |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-LanguageSelection
Geben Sie ein Zeichenfolgenarray von Sprachen an. Clients laden Softwareupdates herunter, die in den angegebenen Sprachen verfügbar sind, und sprachneutrale Updates.
Verwenden Sie das In der Konsole angezeigte Format der Sprache. Zum Beispiel:
EnglishHungarianChinese (Simplified, PRC)
Das Format für das Zeichenfolgenarray lautet: "English","Hungarian","Chinese (Simplified, PRC)"
Tipp
Wenn Sie dieses Cmdlet auf einem Computer ausführen, auf dem Windows über eine lokalisierte Benutzeroberfläche verfügt, können sich die Sprachnamen unterscheiden. Beispielsweise wird in der englischen Version von Windows "Dänisch" verwendet, in der dänischen Version von Windows hingegen "Dansk".
| Typ: | String[] |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-Location
Gibt einen Speicherort in Ihrem Netzwerk an, an dem Computer Softwareupdates herunterladen können. Um diesen Speicherort zu verwenden, geben Sie den Wert für $False den Parameter -DownloadFromInternet an.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-MicrosoftAsVendor
Gibt an, ob die Regel nur Updates enthält, für die Microsoft als Anbieter verwendet wird.
| Typ: | Boolean |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-Name
Gibt einen Namen für die automatische Bereitstellungsregel für Softwareupdates an.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-NoInstallOnRemote
Gibt an, ob die Installation von Updates auf Remotesystemen nicht zugelassen werden soll.
- Wenn Sie den Wert
$Trueangeben, wenn 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 angeben, wird die
$FalseInstallation fortgesetzt.
| Typ: | Boolean |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-NoInstallOnUnprotected
Gibt an, ob die Installation von Updates auf nicht geschützten Systemen nicht zugelassen werden soll.
- Wenn Sie den Wert
$Trueangeben, werden von Configuration Manager keine Softwareupdates heruntergeladen und installiert, wenn keine Softwareupdates auf bevorzugten Verteilungspunkten verfügbar sind. - Wenn Sie den Wert angeben, wird die
$FalseInstallation fortgesetzt.
| Typ: | Boolean |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-O365LanguageSelection
Verwenden Sie diesen Parameter, um die Sprachauswahl für Office 365-Clientupdate festzulegen. Geben Sie ein Zeichenfolgenarray von Sprachen an. Clients laden Softwareupdates herunter, die in den angegebenen Sprachen verfügbar sind, und sprachneutrale Updates.
Verwenden Sie das Format der Sprache, das in der Konsole für die Windows Update-Sprachauswahl angezeigt wird. Dieses Format entspricht dem mit dem LanguageSelection-Parameter . Zum Beispiel:
EnglishHungarianChinese (Simplified, PRC)
Das Format für das Zeichenfolgenarray lautet: "English","Hungarian","Chinese (Simplified, PRC)"
Tipp
Wenn Sie dieses Cmdlet auf einem Computer ausführen, auf dem Windows über eine lokalisierte Benutzeroberfläche verfügt, können sich die Sprachnamen unterscheiden. Beispielsweise wird in der englischen Version von Windows "Dänisch" verwendet, in der dänischen Version von Windows hingegen "Dansk".
Derzeit können Sie mit diesem Parameter nicht alle Sprachen angeben, die in der Configuration Manager-Konsole verfügbar sind. Beispielsweise können Sie nicht "Irisch (Irland)" oder "Maltesisch (Malta)" angeben.
Ab Version 2103 müssen Sie eine Sprache mit einem Landes-/Regionsnamen angeben. Diese Änderung richtet diesen Parameter an den Optionen in der Configuration Manager-Konsole aus. Beispiel: -O365LanguageSelection "English (United States)"
| Typ: | String[] |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-Product
Gibt ein Array von Kriterien als Zeichenfolgen für Softwareupdates an. Die Regel fügt der Softwareupdategruppe Softwareupdates für Produkte hinzu, die bestimmte Kriterien erfüllen.
Ab Version 2107 werden alle Produkte ausgewählt, wenn es mehrere Produkte mit demselben Namen gibt.
| Typ: | String[] |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-Required
Gibt ein Array von Kriterien als Zeichenfolgen für Softwareupdates an. Die Regel fügt der Softwareupdategruppe Softwareupdates hinzu, die von "erforderlich" identifiziert wurden und die angegebenen Kriterien erfüllen.
| Typ: | String[] |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-RequirePostRebootFullScan
Verwenden Sie diesen Parameter, um die folgende Option auf der Seite Benutzerfreundlichkeit der ADR-Bereitstellungseinstellungen festzulegen: Wenn ein Update in dieser Bereitstellung einen Systemneustart erfordert, führen Sie den Bereitstellungsauswertungszyklus updates nach dem Neustart aus.
| Typ: | Boolean |
| Aliase: | RunEvaluationAfterRestart |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-RunType
Geben Sie den wiederkehrenden Zeitplan für den Zeitpunkt an, an dem der Standort die ADR auswertet.
Wenn Sie angeben RunTheRuleOnSchedule, geben Sie einen Zeitplan mit dem Parameter -Schedule an.
| Typ: | RunType |
| Zulässige Werte: | DoNotRunThisRuleAutomatically, RunTheRuleAfterAnySoftwareUpdatePointSynchronization, RunTheRuleOnSchedule |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-Schedule
Gibt ein Zeitplanobjekt für die Bereitstellung an. Verwenden Sie zum Abrufen eines Zeitplanobjekts das Cmdlet New-CMSchedule . Geben Sie einen Zeitplan für diesen Parameter an, wenn Sie den Wert für RunTheRuleOnSchedule den Parameter -RunType angeben.
| Typ: | IResultObject |
| 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 ist
$True, reaktiviert Configuration Manager einen Computer aus dem Ruhezustand. - Wenn dieser Wert ist
$False, werden Computer nicht aus dem Ruhezustand 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 |
-Severity
Gibt ein Array von Schweregraden für Softwareupdates an. Die Regel fügt der Softwareupdategruppe Softwareupdates für die angegebenen Schweregradetypen hinzu.
| Typ: | SeverityType[] |
| Aliase: | Severities |
| Zulässige Werte: | None, Low, Moderate, Important, Critical |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-SoftDeadlineEnabled
Verwenden Sie diesen Parameter, um die folgende Option auf der Seite Bereitstellungszeitplan der ADR-Bereitstellungseinstellungen festzulegen: Erzwingung dieser Bereitstellung gemäß den Benutzereinstellungen bis zur in den Clienteinstellungen definierten Karenzzeit verzögern.
| Typ: | Boolean |
| Aliase: | DelayEnforcementAndUpToGracePeriod |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | 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.
| Typ: | Int32 |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-Superseded
Gibt an, ob die Regel Updates hinzufügt, die durch andere Updates ersetzt werden.
| Typ: | Boolean |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-SuppressRestartServer
Gibt an, ob ein erforderliches Update für einen Server unterdrückt werden soll. Einige Softwareupdates erfordern einen Systemneustart, um den Installationsvorgang abzuschließen.
| Typ: | Boolean |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-SuppressRestartWorkstation
Gibt an, ob ein erforderliches Update für eine Arbeitsstation unterdrückt werden soll. Einige Softwareupdates erfordern einen Systemneustart, um den Installationsvorgang abzuschließen.
| Typ: | Boolean |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-Title
Gibt ein Array von Kriterien als Zeichenfolgen für Softwareupdates an. Die Regel fügt der Softwareupdategruppe Softwareupdates mit Titeln hinzu, die die angegebenen Kriterien erfüllen.
| Typ: | String[] |
| Aliase: | Titles |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-UpdateClassification
Gibt ein Array von Kriterien als Zeichenfolgen für Softwareupdates an. Die Regel fügt der Softwareupdategruppe Softwareupdates hinzu, die über Updateklassifizierungen verfügen, die die angegebenen Kriterien erfüllen.
| Typ: | String[] |
| Aliase: | UpdateClassifications |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-UpdateDeploymentWaitDay
| Typ: | Int32 |
| Aliase: | UpdateDeploymentWaitDays |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-UpdateDescription
Gibt ein Array von Kriterien als Zeichenfolgen für Softwareupdates an. Die Regel fügt der Softwareupdategruppe Softwareupdates hinzu, die über Updatebeschreibungen verfügen, die den angegebenen Kriterien entsprechen.
| Typ: | String[] |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-UseBranchCache
Gibt an, ob Windows BranchCache für diese Updatebereitstellung verwendet werden soll. Wenn Sie den Wert $Trueangeben, teilen Clients Inhalte im gleichen Subnetz.
| Typ: | Boolean |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-UserNotification
Gibt den Typ der Benutzerbenachrichtigung an.
-
DisplayAll: Anzeigen im Softwarecenter und Anzeigen aller Benachrichtigungen. -
DisplaySoftwareCenterOnly: Wird im Softwarecenter angezeigt, und zeigt nur Benachrichtigungen über Computerneustarts an. -
HideAll: Im Softwarecenter und alle Benachrichtigungen ausblenden.
| Typ: | UserNotificationType |
| Zulässige Werte: | DisplayAll, DisplaySoftwareCenterOnly, HideAll |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-UseUtc
Gibt an, ob koordinierte Weltzeit (UTC) verwendet werden soll.
- Wenn dieser Wert ist
$True, verwendet Configuration Manager utc für diese Bereitstellung. - Wenn dieser Wert ist
$False, verwendet Configuration Manager die Ortszeit.
| Typ: | Boolean |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-Vendor
| Typ: | String[] |
| Aliase: | Vendors |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-VerboseLevel
Gibt die Detailebene an, die Clients für Bereitstellungen melden sollen, die von dieser Regel erstellt werden.
| Typ: | VerboseLevelType |
| Zulässige Werte: | OnlyErrorMessages, OnlySuccessAndErrorMessages, AllMessages |
| 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 |
-WriteFilterHandling
Gibt an, ob Schreibfilter für eingebettete Geräte aktiviert werden sollen.
- Für den Wert committet
$Truedas Gerät Änderungen während eines Wartungsfensters. Diese Aktion erfordert einen Neustart. - Für den Wert
$Falsespeichert 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 |
Eingaben
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
Ausgaben
IResultObject
Hinweise
Weitere Informationen zu diesem Rückgabeobjekt und seinen Eigenschaften finden Sie unter SMS_AutoDeployment WMI-Serverklasse.