New-CMOrchestrationGroup
Erstellen Sie eine neue Orchestrierungsgruppe.
Syntax
New-CMOrchestrationGroup
[-Name] <String>
-SiteCode <String>
[-Description <String>]
-OrchestrationType <OrchestrationTypeValue>
[-OrchestrationValue <Int32>]
[-OrchestrationTimeOutMin <Int32>]
[-MaxLockTimeOutMin <Int32>]
[-PreScript <String>]
[-PreScriptTimeoutSec <Int32>]
[-PostScript <String>]
[-PostScriptTimeoutSec <Int32>]
-MemberResourceIds <Int32[]>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Beschreibung
Verwenden Sie dieses Cmdlet, um eine neue Orchestrierungsgruppe zu erstellen.
Verwenden Sie Orchestrierungsgruppen, um die Bereitstellung von Softwareupdates auf Geräten besser zu steuern. Möglicherweise müssen Sie Updates für bestimmte Workloads sorgfältig verwalten oder das Verhalten dazwischen automatisieren. Weitere Informationen finden Sie unter Erstellen und Verwenden von Orchestrierungsgruppen in Configuration Manager.
Hinweis
Führen Sie Configuration Manager-Cmdlets auf dem Configuration Manager-Standortlaufwerk aus, z. B PS XYZ:\>. . Weitere Informationen finden Sie unter Erste Schritte.
Beispiele
Beispiel 1
In diesem Beispiel werden die Cmdlet-Parameter zuerst in die Parametervariablesplatsiert. Es ist nicht erforderlich, die Parameter zu splatieren, es erleichtert nur das Lesen der Parameter für eine so lange Befehlszeile.
Es wird davon ausgegangen, dass Sie über Objekte für die Geräte verfügen, die der Orchestrierungsgruppe in den Gerätevariablen hinzugefügt werden sollen.
Der Befehl erstellt eine Orchestrierungsgruppe mit den Standardeinstellungen und einfachen Skripts zu Testzwecken.
$parameters = @{
Name = "IT servers"
SiteCode = "XYZ"
Description = "An OG for IT servers with default settings"
OrchestrationType = "Number"
OrchestrationValue = 1
OrchestrationTimeOutMin = 720
MaxLockTimeOutMin = 60
PreScript = "Write-Host 'Pre-install script'"
PreScriptTimeoutSec = 120
PostScript = "Write-Host 'POST-install script'"
PostScriptTimeoutSec = 120
MemberResourceIds = $device1.ResourceID, $device2.ResourceID
}
New-CMOrchestrationGroup @parametersParameter
-Confirm
Fordert Sie vor dem Ausführen des Cmdlets zur Bestätigung auf.
| Typ: | SwitchParameter |
| Aliase: | cf |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-Description
Geben Sie eine optionale Beschreibung für die Orchestrierungsgruppe an, um sie zu identifizieren.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-DisableWildcardHandling
Dieser Parameter behandelt Wildcardzeichen als Literalzeichenwerte. Sie können es nicht mit ForceWildcardHandling kombinieren.
| Typ: | SwitchParameter |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-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 |
-MaxLockTimeOutMin
Geben Sie einen ganzzahligen Wert für das Timeout des Orchestrierungsgruppenmitglieds in Minuten an. Dieser Wert ist das Zeitlimit für ein einzelnes Gerät in der Gruppe, um die Updates zu installieren.
| Typ: | Int32 |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-MemberResourceIds
Geben Sie ein Array von Ressourcen-IDs für die Geräte an, die als Mitglieder dieser Orchestrierungsgruppe hinzugefügt werden sollen. Die Ressourcen-ID ist eine ganze Zahl, z. B 16777220. . Dies ist die ResourceId-Eigenschaft auf einem Gerät oder Ressourcenobjekt. Verwenden Sie zum Abrufen eines Geräteobjekts die Cmdlets Get-CMDevice oder Get-CMResource .
Wenn Sie den Parameter OrchestrationType auf Sequencefestlegen, verwenden Sie diesen Parameter, um die Reihenfolge zu bestimmen.
| Typ: | Int32[] |
| Aliase: | MogMembers |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-Name
Geben Sie einen Namen für die Orchestrierungsgruppe an.
| Typ: | String |
| Aliase: | OrchestrationGroupName |
| Position: | 0 |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-OrchestrationTimeOutMin
Geben Sie einen ganzzahligen Wert für das Timeout der Orchestrierungsgruppe in Minuten an. Dieser Wert ist das Zeitlimit für alle Gruppenmitglieder, um die Updates zu installieren.
| Typ: | Int32 |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-OrchestrationType
Geben Sie einen der folgenden Werte für den Typ der Orchestrierungsgruppe an:
Number: Zulassen, dass mehrere Geräte gleichzeitig aktualisiert werden können. Verwenden Sie diese Einstellung, um immer auf eine bestimmte Anzahl von Geräten zu beschränken, unabhängig von der Gesamtgröße der Orchestrierungsgruppe. Verwenden Sie den Parameter OrchestrationValue , um die Anzahl der Geräte anzugeben.Percentage: Zulassen, dass ein Prozentsatz der Geräte gleichzeitig aktualisiert wird. Verwenden Sie diese Einstellung, um zukünftige Flexibilität bei der Größe der Orchestrierungsgruppe zu ermöglichen. Verwenden Sie den Parameter OrchestrationValue , um den Prozentsatz anzugeben.Sequence: Definieren Sie explizit die Reihenfolge, in der Geräte die Softwareupdatebereitstellung ausführen. Die Reihenfolge wird durch die Art der Geräteressourcen-IDs im MemberResourceIds-Parameter bestimmt.
| Typ: | OrchestrationTypeValue |
| Zulässige Werte: | Number, Percentage, Sequence |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-OrchestrationValue
Geben Sie eine ganze Zahl für die Anzahl oder den Prozentsatz der Geräte an, die gleichzeitig aktualisiert werden sollen. Verwenden Sie diesen Parameter, wenn Sie den OrchestrationType-Parameter auf Number oder Percentagefestlegen.
| Typ: | Int32 |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-PostScript
Geben Sie bei Bedarf das PowerShell-Skript an, das auf jedem Gerät ausgeführt werden soll, nachdem die Bereitstellung ausgeführt und das Gerät neu gestartet wird.
Dieser Zeichenfolgenwert ist der Text des Skripts selbst. Wenn Sie über ein Skript in einer Datei verfügen, die Sie verwenden möchten, lesen Sie es zuerst in eine Variable. Verwenden Sie beispielsweise das integrierte Cmdlet Get-Content .
Die Skripts sollten den Wert für 0 Erfolg zurückgeben. Jeder Wert ungleich 0 (null) wird als Skriptfehler betrachtet. Sie können kein Skript mit Parametern verwenden. Die maximale Skriptlänge beträgt 50.000 Zeichen.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-PostScriptTimeoutSec
Geben Sie den ganzzahligen Wert für die zulässige Zeit in Sekunden an, für die das Post-Skript ausgeführt werden soll, bevor ein Timeout aufgetreten ist.
| Typ: | Int32 |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-PreScript
Geben Sie das PowerShell-Skript an, das auf jedem Gerät ausgeführt werden soll, bevor die Bereitstellung ausgeführt wird.
Dieser Zeichenfolgenwert ist der Text des Skripts selbst. Wenn Sie über ein Skript in einer Datei verfügen, die Sie verwenden möchten, lesen Sie es zuerst in eine Variable. Verwenden Sie beispielsweise das integrierte Cmdlet Get-Content .
Die Skripts sollten den Wert für 0 Erfolg zurückgeben. Jeder Wert ungleich 0 (null) wird als Skriptfehler betrachtet. Sie können kein Skript mit Parametern verwenden. Die maximale Skriptlänge beträgt 50.000 Zeichen.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-PreScriptTimeoutSec
Geben Sie den ganzzahligen Wert für die zulässige Zeit in Sekunden für die Ausführung des Vorskripts an, bevor ein Timeout aufgetreten ist.
| Typ: | Int32 |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-SiteCode
Geben Sie den Standortcode für diese Orchestrierungsgruppe und ihre Mitglieder an.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | True |
| 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: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
Eingaben
None
Ausgaben
IResultObject
Hinweise
Dieses Cmdlet gibt ein Objekt für die SMS_MachineOrchestrationGroup WMI-Klasse zurück.