Freigeben über


Get-CMOrchestrationGroup

Ruft ein Orchestrierungsgruppenobjekt ab.

Syntax

Get-CMOrchestrationGroup
   [[-Name] <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]
Get-CMOrchestrationGroup
   [-Id] <Int32>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]

Beschreibung

Verwenden Sie dieses Cmdlet, um ein Orchestrierungsgruppenobjekt nach Name oder ID abzurufen. Sie können dieses Objekt verwenden, um die Orchestrierungsgruppe zu starten, zu entfernen oder zu konfigurieren. Verwenden Sie für diese anderen Aktionen die folgenden Cmdlets:

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 Informationen zu 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: Anzeigen von Details zu Mitgliedern einer Orchestrierungsgruppe

In diesem Beispiel wird zunächst das Cmdlet Get-CMOrchestrationGroup verwendet, um ein Objekt für die Orchestrierungsgruppe mit dem Namen IT-Server abzurufen.

Anschließend durchläuft er jedes Mitglied der Orchestrierungsgruppe, das anhand seiner Ressourcen-ID gespeichert wird. Anschließend wird das Cmdlet Get-CMDevice verwendet, um den Gerätenamen und die Buildeigenschaften des Betriebssystems anzuzeigen.

$og = Get-CMOrchestrationGroup -Name "IT servers"

foreach ( $member in $og.MOGMembers ) {
  Get-CMDevice -Id $member -Fast | Select-Object Name, Build
}

Beispiel 2: Abrufen von Orchestrierungsgruppen mit nicht genehmigten Skripts

Im folgenden Beispiel werden alle Orchestrierungsgruppen von der Website abgerufen. Es verwendet das integrierte Cmdlet Where-Object , um die Ergebnisse zu filtern, die über eine der Eigenschaften des Skriptgenehmigungszustands mit dem Wert verfügen 0. Der Pipelineoperator wird erneut verwendet, um die zurückgegebenen Eigenschaften mit dem integrierten Cmdlet Select-Object so zu reduzieren, dass nur der Name der Orchestrierungsgruppen angezeigt wird.

Sie können dieses Beispiel verwenden, um alle Orchestrierungsgruppen anzuzeigen, die entweder über ein Prä- oder Postskript verfügen, das nicht genehmigt wurde.

Get-CMOrchestrationGroup | Where-Object ( $_.PostScriptApprovalState -eq $false -or $_.PreScriptApprovalState -eq $false ) | Select-Object Name

Parameter

-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

-Id

Geben Sie die ID der abzurufenden Orchestrierungsgruppe an. Dieser Wert ist die MOGID-Eigenschaft , die eine ganze Zahl ist. Beispiel: 16777217.

Typ:Int32
Aliase:MOGID
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Name

Geben Sie den Namen der abzurufenden Orchestrierungsgruppe an.

Typ:String
Aliase:OrchestrationGroupName
Position:0
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.