New-CMOrchestrationGroup
Créez un groupe d’orchestration.
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>]
Description
Utilisez cette applet de commande pour créer un groupe d’orchestration.
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 Créer et utiliser 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
Cet exemple montre comment d’abordplate les paramètres de l’applet de commande dans la variable parameters . 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.
Il suppose que vous avez des objets pour les appareils à ajouter au groupe d’orchestration dans les variables d’appareil .
La commande crée un groupe d’orchestration avec les paramètres par défaut et les scripts simples à des fins de test.
$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
Paramètres
-Confirm
Une invite de confirmation apparaît avant d’exécuter le cmdlet.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Description
Spécifiez une description facultative pour le groupe d’orchestration afin de l’identifier.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-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 |
-MaxLockTimeOutMin
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.
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-MemberResourceIds
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.
Type: | Int32[] |
Aliases: | MogMembers |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Name
Spécifiez un nom pour le groupe d’orchestration.
Type: | String |
Aliases: | OrchestrationGroupName |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-OrchestrationTimeOutMin
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.
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-OrchestrationType
Spécifiez l’une des valeurs suivantes pour le type de groupe d’orchestration :
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 .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 .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 .
Type: | OrchestrationTypeValue |
Accepted values: | Number, Percentage, Sequence |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-OrchestrationValue
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
.
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PostScript
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.
Cette 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.
Les 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.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PostScriptTimeoutSec
Spécifiez la valeur entière pour la durée autorisée en secondes pour l’exécution du post-script avant son expiration.
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PreScript
Spécifiez le script PowerShell à exécuter sur chaque appareil avant l’exécution du déploiement.
Cette 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.
Les 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.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PreScriptTimeoutSec
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.
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SiteCode
Spécifiez le code de site pour ce groupe d’orchestration et ses membres.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
Présente ce qui se produit si le cmdlet s’exécute. L’applet de commande ne s’exécute pas.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
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 .
Liens associés
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour