Partager via


Get-CMOrchestrationGroup

Obtenir un objet de groupe d’orchestration.

Syntaxe

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

Description

Utilisez cette applet de commande pour obtenir un objet de groupe d’orchestration par nom ou ID. Vous pouvez utiliser cet objet pour démarrer, supprimer ou configurer le groupe d’orchestration. Pour ces autres actions, utilisez les applets de commande suivantes :

Utilisez des groupes d’orchestration pour mieux contrôler le déploiement des mises à jour logicielles sur les appareils. Vous devrez peut-être gérer soigneusement les mises à jour pour des charges de travail spécifiques ou automatiser les comportements entre les deux. Pour plus d’informations, consultez À propos des groupes d’orchestration dans Configuration Manager.

Remarque

Exécutez des applets de commande Configuration Manager à partir du lecteur de site Configuration Manager, par exemple PS XYZ:\>. Pour plus d’informations, consultez Prise en main.

Exemples

Exemple 1 : Afficher des détails sur les membres d’un groupe d’orchestration

Cet exemple utilise d’abord l’applet de commande Get-CMOrchestrationGroup pour obtenir un objet pour le groupe d’orchestration nommé serveurs informatiques.

Il effectue ensuite une boucle dans chaque membre du groupe d’orchestration, qui est stocké par son ID de ressource. Il utilise ensuite l’applet de commande Get-CMDevice pour afficher le nom de l’appareil et les propriétés de build du système d’exploitation.

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

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

Exemple 2 : Obtenir des groupes d’orchestration avec des scripts non approuvés

L’exemple suivant obtient tous les groupes d’orchestration du site. Il utilise l’applet de commande Where-Object intégrée pour filtrer les résultats qui ont l’une des propriétés d’état d’approbation du script avec la valeur 0. Il utilise à nouveau l’opérateur de pipeline pour réduire les propriétés retournées avec l’applet de commande Intégrée Select-Object pour afficher uniquement le nom des groupes d’orchestration.

Vous pouvez utiliser cet exemple pour afficher tous les groupes d’orchestration qui ont un pré-script ou un post-script qui n’est pas approuvé.

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

Paramètres

-DisableWildcardHandling

Ce paramètre traite les caractères génériques comme des valeurs de caractère littéral. Vous ne pouvez pas la combiner avec ForceWildcardHandling.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-ForceWildcardHandling

Ce paramètre traite les caractères génériques et peut entraîner un comportement inattendu (non recommandé). Vous ne pouvez pas la combiner avec DisableWildcardHandling.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Id

Spécifiez l’ID du groupe d’orchestration à obtenir. Cette valeur est la propriété MOGID , qui est un entier. Par exemple : 16777217.

Type:Int32
Alias:MOGID
Position:0
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Name

Spécifiez le nom du groupe d’orchestration à obtenir.

Type:String
Alias:OrchestrationGroupName
Position:0
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

Entrées

None

Sorties

IResultObject

Notes

Cette applet de commande retourne un objet pour la classe WMI SMS_MachineOrchestrationGroup .