Share via

Get-CMOrchestrationGroup

  • Référence
Module:
ConfigurationManager

Obtenir un objet de groupe d’orchestration.

Syntax

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 Configuration Manager applets de commande à 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
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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
Aliases:MOGID
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Name

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

Type:String
Aliases:OrchestrationGroupName
Position:0
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Entrées

None

Sorties

IResultObject

Notes

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