Configurer un groupe d’orchestration.
\n","uid":"ConfigurationManager.Set-CMOrchestrationGroup"}],"ocv-translation-feedback":true},"_xrefmap":{"ConfigurationManager":{"href":"./","monikerGroup":"f98fea35b6ac2b0f56c6ee5ec06ffce9","name":"ConfigurationManager","schemaType":"PowershellModule","uid":"ConfigurationManager"},"ConfigurationManager.Set-CMOrchestrationGroup":{"href":"set-cmorchestrationgroup","monikerGroup":"f98fea35b6ac2b0f56c6ee5ec06ffce9","name":"Set-CMOrchestrationGroup","schemaType":"PowershellCmdlet","summary":"Configurer un groupe d’orchestration.
\n","uid":"ConfigurationManager.Set-CMOrchestrationGroup"}},"description":"Utilisez cette applet de commande pour configurer un groupe d’orchestration.
\nUtilisez 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 Créer et utiliser des groupes d’orchestration dans Configuration Manager.
\nRemarque
\nExé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.
Cet exemple montre comment effectuer un type programmatique des membres existants. Si l’appartenance au groupe d’orchestration ne change pas, elle utilise le processus général suivant :
\nCet exemple utilise Get-CMDevice pour obtenir plus d’informations, mais vous pouvez le remplacer par n’importe quelle applet de commande qui utilise l’ID de ressource d’appareil comme entrée. Vous pouvez également remplacer le mécanisme de tri par une autre fonction.
\n","summary":"Cet exemple utilise d’abord l’applet de commande Get-CMOrchestrationGroup pour obtenir un objet pour le groupe d’orchestration nommé serveurs informatiques. Il stocke cet objet dans la variable og .
\nLa commande suivante définit un tableau nommé devices. Il effectue une boucle dans chaque membre du groupe d’orchestration des serveurs informatiques ($og.MOGMembers) et transmet l’ID du membre à l’applet de commande Get-CMDevice . L’objet d’appareil retourné est ajouté au tableau d’appareils .
La commande suivante trie le tableau par nom d’appareil et retourne les ID de ressource d’appareil dans la variable tridIDs .
\nIl place ensuite les paramètres de l’applet de commande dans la variable de paramètres . Il n’est pas nécessaire de plaquer les paramètres. Cela facilite simplement la lecture des paramètres pour une ligne de commande aussi longue.
\nLa dernière commande configure le groupe d’orchestration spécifié avec un ordre de séquence défini. Il utilise le paramètre MemberResourceIds pour définir la séquence, et non pour ajouter ou supprimer des membres.
\n","title":"Exemple 1 : Modifier le type et spécifier la séquence"},{"code":"$postScript - Get-Content -Path \"D:\\Scripts\\OG\\Post1.ps1\"\nSet-CMOrchestrationGroup -InputObject $og -PostScript $postScript","description":"","summary":"Cet exemple utilise l’applet de commande Get-Content intégrée pour lire le texte du script à partir d’un fichier local. Il stocke le texte du script dans la variable postScript . La deuxième commande configure le groupe d’orchestration avec le nouveau post-script.
\n","title":"Exemple 2 : Obtenir le contenu du script à partir d’un fichier"}],"inputs":[{"description":"","name":"Microsoft.ConfigurationManagement.ManagementProvider.IResultObject\n"}],"links":[{"href":"get-cmorchestrationgroup","text":"Get-CMOrchestrationGroup"},{"href":"invoke-cmorchestrationgroup","text":"Invoke-CMOrchestrationGroup"},{"href":"new-cmorchestrationgroup","text":"New-CMOrchestrationGroup"},{"href":"remove-cmorchestrationgroup","text":"Remove-CMOrchestrationGroup"},{"href":"/mem/configmgr/sum/deploy-use/orchestration-groups","text":"À propos des groupes d’orchestration dans Configuration Manager"}],"module":"ConfigurationManager","name":"Set-CMOrchestrationGroup","notes":"Cette applet de commande retourne un objet pour la classe WMI SMS_MachineOrchestrationGroup .
\n","outputs":[{"description":"","name":"IResultObject\n"}],"parameters":[{"aliases":"cf","defaultValue":"None","description":"Une invite de confirmation apparaît avant d’exécuter le cmdlet.
\n","name":"Confirm","parameterValueGroup":"","position":"Named","type":"SwitchParameter\n"},{"aliases":"","defaultValue":"None","description":"Spécifiez une description facultative pour le groupe d’orchestration afin de l’identifier.
\n","name":"Description","parameterValueGroup":"","position":"Named","type":"String\n"},{"aliases":"","defaultValue":"None","description":"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.
\n","name":"DisableWildcardHandling","parameterValueGroup":"","position":"Named","type":"SwitchParameter\n"},{"aliases":"","defaultValue":"None","description":"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.
\n","name":"ForceWildcardHandling","parameterValueGroup":"","position":"Named","type":"SwitchParameter\n"},{"aliases":"MOGID","defaultValue":"None","description":"Spécifiez l’ID du groupe d’orchestration à configurer. Cette valeur est la propriété MOGID , qui est un entier. Par exemple : 16777217.
Spécifiez un objet pour le groupe d’orchestration à configurer. Pour obtenir cet objet, utilisez l’applet de commande Get-CMOrchestrationGroup .
\n","isRequired":true,"name":"InputObject","parameterValueGroup":"","pipelineInput":true,"position":"0","type":"IResultObject\n"},{"aliases":"","defaultValue":"None","description":"Spécifiez une valeur entière pour le délai d’expiration du membre du groupe d’orchestration en minutes. Cette valeur est la limite de temps pour qu’un seul appareil du groupe installe les mises à jour.
\n","name":"MaxLockTimeOutMin","parameterValueGroup":"","position":"Named","type":"Int32\n"},{"aliases":"MogMembers","defaultValue":"None","description":"Spécifiez un tableau d’ID de ressource pour les appareils à ajouter en tant que membres de ce groupe d’orchestration. L’ID de ressource est un entier, par exemple. 16777220 Il s’agit de la propriété ResourceId sur un appareil ou un objet de ressource. Pour obtenir un objet d’appareil, utilisez les applets de commande Get-CMDevice ou Get-CMResource .
Lorsque vous définissez le paramètre OrchestrationType sur Sequence, utilisez ce paramètre pour déterminer l’ordre.
Int32[]
\n"},{"aliases":"OrchestrationGroupName","defaultValue":"None","description":"Spécifiez le nom du groupe d’orchestration à configurer.
\n","isRequired":true,"name":"Name","parameterValueGroup":"","position":"0","type":"String\n"},{"aliases":"","defaultValue":"None","description":"Spécifiez un nouveau nom pour ce groupe d’orchestration. Utilisez ce paramètre pour renommer le groupe d’orchestration.
\n","name":"NewName","parameterValueGroup":"","position":"Named","type":"String\n"},{"aliases":"","defaultValue":"None","description":"Spécifiez une valeur entière pour le délai d’expiration du groupe d’orchestration en minutes. Cette valeur est la limite de temps pour que tous les membres du groupe installent les mises à jour.
\n","name":"OrchestrationTimeOutMin","parameterValueGroup":"","position":"Named","type":"Int32\n"},{"aliases":"","defaultValue":"None","description":"Spécifiez l’une des valeurs suivantes pour le type de groupe d’orchestration :
\n\n Number: autorisez un certain nombre d’appareils à mettre à jour en même temps. Utilisez ce paramètre pour toujours limiter à un nombre spécifique d’appareils, quelle que soit la taille globale du groupe d’orchestration. Pour spécifier le nombre d’appareils, utilisez le paramètre OrchestrationValue .
\n Percentage: autorisez un pourcentage des appareils à mettre à jour en même temps. Utilisez ce paramètre pour permettre une flexibilité future de la taille du groupe d’orchestration. Pour spécifier le pourcentage, utilisez le paramètre OrchestrationValue .
\n Sequence: définissez explicitement l’ordre dans lequel les appareils exécutent le déploiement des mises à jour logicielles. L’ordre est déterminé par le type des ID de ressource d’appareil dans le paramètre MemberResourceIds .
Spécifiez un entier pour le nombre ou le pourcentage d’appareils à mettre à jour en même temps. Utilisez ce paramètre lorsque vous définissez le paramètre OrchestrationType sur Number ou Percentage.
Spécifiez le script PowerShell à exécuter sur chaque appareil après l’exécution du déploiement et le redémarrage de l’appareil, si nécessaire.
\nCette valeur de chaîne est le texte du script lui-même. Si vous avez un script dans un fichier que vous souhaitez utiliser, commencez par le lire dans une variable. Par exemple, utilisez l’applet de commande Get-Content intégrée.
\nLes scripts doivent retourner une valeur de 0 réussite. Toute valeur différente de zéro est considérée comme un échec de script. Vous ne pouvez pas utiliser de script avec des paramètres. La longueur maximale du script est de 50 000 caractères.
Spécifiez la valeur entière pour la durée autorisée en secondes pour l’exécution du post-script avant son expiration.
\n","name":"PostScriptTimeoutSec","parameterValueGroup":"","position":"Named","type":"Int32\n"},{"aliases":"","defaultValue":"None","description":"Spécifiez le script PowerShell à exécuter sur chaque appareil avant l’exécution du déploiement.
\nCette valeur de chaîne est le texte du script lui-même. Si vous avez un script dans un fichier que vous souhaitez utiliser, commencez par le lire dans une variable. Par exemple, utilisez l’applet de commande Get-Content intégrée.
\nLes scripts doivent retourner une valeur de 0 réussite. Toute valeur différente de zéro est considérée comme un échec de script. Vous ne pouvez pas utiliser de script avec des paramètres. La longueur maximale du script est de 50 000 caractères.
Spécifiez la valeur entière pour la durée autorisée en secondes pour que le pré-script s’exécute avant son expiration.
\n","name":"PreScriptTimeoutSec","parameterValueGroup":"","position":"Named","type":"Int32\n"},{"aliases":"wi","defaultValue":"None","description":"Présente ce qui se produit si le cmdlet s’exécute. L’applet de commande ne s’exécute pas.
\n","name":"WhatIf","parameterValueGroup":"","position":"Named","type":"SwitchParameter\n"}],"schema":"PowershellCmdlet","summary":"Configurer un groupe d’orchestration.
\n","syntaxes":["Set-CMOrchestrationGroup [-InputObject]Configurer un groupe d’orchestration.
\n","uid":"ConfigurationManager.Set-CMOrchestrationGroup"}],"canonical_url":"https://learn.microsoft.com/fr-fr/powershell/module/configurationmanager/set-cmorchestrationgroup?view=sccm-ps","_op_canonicalUrl":"https://learn.microsoft.com/fr-fr/powershell/module/configurationmanager/set-cmorchestrationgroup?view=sccm-ps"},"pageMetadata":"Utilisez cette applet de commande pour configurer un groupe d’orchestration.\nUtilisez 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 Créer et utiliser des groupes d’orchestration dans Configuration Manager.
\nRemarque
\nExé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.