Crie um novo grupo de orquestração.
\n","uid":"ConfigurationManager.New-CMOrchestrationGroup"}],"ocv-translation-feedback":true},"_xrefmap":{"ConfigurationManager":{"href":"./","monikerGroup":"f98fea35b6ac2b0f56c6ee5ec06ffce9","name":"ConfigurationManager","schemaType":"PowershellModule","uid":"ConfigurationManager"},"ConfigurationManager.New-CMOrchestrationGroup":{"href":"new-cmorchestrationgroup","monikerGroup":"f98fea35b6ac2b0f56c6ee5ec06ffce9","name":"New-CMOrchestrationGroup","schemaType":"PowershellCmdlet","summary":"Crie um novo grupo de orquestração.
\n","uid":"ConfigurationManager.New-CMOrchestrationGroup"}},"description":"Use este cmdlet para criar um novo grupo de orquestração.
\nUse grupos de orquestração para controlar melhor a implantação de atualizações de software em dispositivos. Pode ser necessário gerenciar cuidadosamente as atualizações para cargas de trabalho específicas ou automatizar comportamentos entre elas. Para obter mais informações, consulte Criar e usar grupos de orquestração no Configuration Manager.
\nObservação
\nExecute cmdlets do Configuration Manager na unidade do site do Configuration Manager, por exemploPS XYZ:\\>. Para obter mais informações, consulte introdução.
Este exemplo primeiro coloca os parâmetros do cmdlet na variável parameters . Não é necessário splat os parâmetros, apenas facilita a leitura dos parâmetros para uma linha de comando tão longa.
\nEle pressupõe que você tenha objetos para os dispositivos a serem adicionados ao grupo de orquestração nas variáveis do dispositivo .
\nO comando cria um grupo de orquestração com as configurações padrão e scripts simples para fins de teste.
\n","title":"Exemplo 1"}],"inputs":[{"description":"","name":"None\n"}],"links":[{"href":"get-cmorchestrationgroup","text":"Get-CMOrchestrationGroup"},{"href":"invoke-cmorchestrationgroup","text":"Invoke-CMOrchestrationGroup"},{"href":"remove-cmorchestrationgroup","text":"Remove-CMOrchestrationGroup"},{"href":"set-cmorchestrationgroup","text":"Set-CMOrchestrationGroup"},{"href":"/mem/configmgr/sum/deploy-use/orchestration-groups","text":"Sobre grupos de orquestração no Configuration Manager"}],"module":"ConfigurationManager","name":"New-CMOrchestrationGroup","notes":"Esse cmdlet retorna um objeto para a classe SMS_MachineOrchestrationGroup WMI.
\n","outputs":[{"description":"","name":"IResultObject\n"}],"parameters":[{"aliases":"cf","defaultValue":"None","description":"Solicita a confirmação antes de executar o cmdlet.
\n","name":"Confirm","parameterValueGroup":"","position":"Named","type":"SwitchParameter\n"},{"aliases":"","defaultValue":"None","description":"Especifique uma descrição opcional para o grupo de orquestração para ajudar a identificá-lo.
\n","name":"Description","parameterValueGroup":"","position":"Named","type":"String\n"},{"aliases":"","defaultValue":"None","description":"Esse parâmetro trata caracteres curinga como valores de caracteres literais. Você não pode combiná-lo com ForceWildcardHandling.
\n","name":"DisableWildcardHandling","parameterValueGroup":"","position":"Named","type":"SwitchParameter\n"},{"aliases":"","defaultValue":"None","description":"Esse parâmetro processa caracteres curinga e pode levar a um comportamento inesperado (não recomendado). Você não pode combiná-lo com DisableWildcardHandling.
\n","name":"ForceWildcardHandling","parameterValueGroup":"","position":"Named","type":"SwitchParameter\n"},{"aliases":"","defaultValue":"None","description":"Especifique um valor inteiro para o tempo limite do membro do grupo de orquestração em minutos. Esse valor é o limite de tempo para que um único dispositivo do grupo instale as atualizações.
\n","name":"MaxLockTimeOutMin","parameterValueGroup":"","position":"Named","type":"Int32\n"},{"aliases":"MogMembers","defaultValue":"None","description":"Especifique uma matriz de IDs de recurso para os dispositivos a serem adicionados como membros desse grupo de orquestração. A ID do recurso é um número inteiro, por exemplo, 16777220. É a propriedade ResourceId em um dispositivo ou objeto de recurso. Para obter um objeto de dispositivo, use os cmdlets Get-CMDevice ou Get-CMResource .
Ao definir o parâmetro OrchestrationType para Sequence, use esse parâmetro para determinar a ordem.
Int32[]
\n"},{"aliases":"OrchestrationGroupName","defaultValue":"None","description":"Especifique um nome para o grupo de orquestração.
\n","isRequired":true,"name":"Name","parameterValueGroup":"","position":"0","type":"String\n"},{"aliases":"","defaultValue":"None","description":"Especifique um valor inteiro para o tempo limite do grupo de orquestração em minutos. Esse valor é o limite de tempo para que todos os membros do grupo instalem as atualizações.
\n","name":"OrchestrationTimeOutMin","parameterValueGroup":"","position":"Named","type":"Int32\n"},{"aliases":"","defaultValue":"None","description":"Especifique um dos seguintes valores para o tipo de grupo de orquestração:
\n\n Number: permita que vários dispositivos sejam atualizados ao mesmo tempo. Use essa configuração para sempre se limitar a um número específico de dispositivos, seja qual for o tamanho geral do grupo de orquestração. Para especificar o número de dispositivos, use o parâmetro OrchestrationValue .
\n Percentage: Permitir que uma porcentagem dos dispositivos seja atualizada ao mesmo tempo. Use essa configuração para permitir flexibilidade futura do tamanho do grupo de orquestração. Para especificar a porcentagem, use o parâmetro OrchestrationValue .
\n Sequence: Defina explicitamente a ordem na qual os dispositivos executam a implantação de atualização de software. A ordem é determinada pela classificação das IDs de recurso de dispositivo no parâmetro MemberResourceIds .
Especifique um número inteiro para o número ou a porcentagem de dispositivos a serem atualizados ao mesmo tempo. Use esse parâmetro ao definir o parâmetro OrchestrationType como Number ou Percentage.
Especifique o script do PowerShell a ser executado em cada dispositivo após a implantação ser executada e o dispositivo reiniciado, se necessário.
\nEsse valor de cadeia de caracteres é o texto do próprio script. Se você tiver um script em um arquivo que deseja usar, primeiro leia-o em uma variável. Por exemplo, use o cmdlet interno Get-Content .
\nOs scripts devem retornar um valor de 0 for success. Qualquer valor diferente de zero é considerado uma falha de script. Você não pode usar um script com parâmetros. O comprimento máximo do script é de 50.000 caracteres.
Especifique o valor inteiro do tempo permitido em segundos para que o pós-script seja executado antes que ele atinja o tempo limite.
\n","name":"PostScriptTimeoutSec","parameterValueGroup":"","position":"Named","type":"Int32\n"},{"aliases":"","defaultValue":"None","description":"Especifique o script do PowerShell a ser executado em cada dispositivo antes da execução da implantação.
\nEsse valor de cadeia de caracteres é o texto do próprio script. Se você tiver um script em um arquivo que deseja usar, primeiro leia-o em uma variável. Por exemplo, use o cmdlet interno Get-Content .
\nOs scripts devem retornar um valor de 0 for success. Qualquer valor diferente de zero é considerado uma falha de script. Você não pode usar um script com parâmetros. O comprimento máximo do script é de 50.000 caracteres.
Especifique o valor inteiro do tempo permitido em segundos para que o pré-script seja executado antes que ele atinja o tempo limite.
\n","name":"PreScriptTimeoutSec","parameterValueGroup":"","position":"Named","type":"Int32\n"},{"aliases":"","defaultValue":"None","description":"Especifique o código de site para esse grupo de orquestração e seus membros.
\n","isRequired":true,"name":"SiteCode","parameterValueGroup":"","position":"Named","type":"String\n"},{"aliases":"wi","defaultValue":"None","description":"Mostrar o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.
\n","name":"WhatIf","parameterValueGroup":"","position":"Named","type":"SwitchParameter\n"}],"schema":"PowershellCmdlet","summary":"Crie um novo grupo de orquestração.
\n","syntaxes":["New-CMOrchestrationGroup [-Name]Crie um novo grupo de orquestração.
\n","uid":"ConfigurationManager.New-CMOrchestrationGroup"}],"canonical_url":"https://learn.microsoft.com/pt-br/powershell/module/configurationmanager/new-cmorchestrationgroup?view=sccm-ps","_op_canonicalUrl":"https://learn.microsoft.com/pt-br/powershell/module/configurationmanager/new-cmorchestrationgroup?view=sccm-ps"},"pageMetadata":"Use este cmdlet para criar um novo grupo de orquestração.\nUse grupos de orquestração para controlar melhor a implantação de atualizações de software em dispositivos. Pode ser necessário gerenciar cuidadosamente as atualizações para cargas de trabalho específicas ou automatizar comportamentos entre elas. Para obter mais informações, consulte Criar e usar grupos de orquestração no Configuration Manager.
\nObservação
\nExecute cmdlets do Configuration Manager na unidade do site do Configuration Manager, por exemploPS XYZ:\\>. Para obter mais informações, consulte introdução.