New-CMOrchestrationGroup

  • Referenz
Modul:
ConfigurationManager

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-Websitelaufwerk aus, z. PS XYZ:\>B. . 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 @parameters

Parameter

-Confirm

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

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

-Description

Geben Sie eine optionale Beschreibung für die Orchestrierungsgruppe an, um sie zu identifizieren.

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

-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

-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.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:Int32[]
Aliases:MogMembers
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Name

Geben Sie einen Namen für die Orchestrierungsgruppe an.

Type:String
Aliases:OrchestrationGroupName
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters: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.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:OrchestrationTypeValue
Accepted values:Number, Percentage, Sequence
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters: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.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

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

-SiteCode

Geben Sie den Standortcode für diese Orchestrierungsgruppe und ihre Mitglieder an.

Type:String
Position:Named
Default value:None
Required:True
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:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Eingaben

None

Ausgaben

IResultObject

Hinweise

Dieses Cmdlet gibt ein Objekt für die SMS_MachineOrchestrationGroup WMI-Klasse zurück.