New-CMOrchestrationGroup

  • Referência
Módulo:
ConfigurationManager

Crie um novo grupo de orquestração.

Sintaxe

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

Utilize este cmdlet para criar um novo grupo de orquestração.

Utilize grupos de orquestração para controlar melhor a implementação de atualizações de software em dispositivos. Poderá ter de gerir cuidadosamente as atualizações de cargas de trabalho específicas ou automatizar comportamentos intermédios. Para obter mais informações, veja Criar e utilizar grupos de orquestração no Configuration Manager.

Observação

Execute cmdlets do Configuration Manager a partir da unidade do site do Configuration Manager, por exemplo PS XYZ:\>. Para obter mais informações, veja Introdução.

Exemplos

Exemplo 1

Este exemplo introduz primeiro os parâmetros do cmdlet na variável parameters . Não é necessário alterar os parâmetros, apenas facilita a leitura dos parâmetros para uma linha de comandos tão longa.

Pressupõe que tem objetos para os dispositivos adicionarem ao grupo de orquestração nas variáveis do dispositivo .

O comando cria um grupo de orquestração com as predefinições e scripts simples para fins de teste.

$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

Parâmetros

-Confirm

Solicita a confirmação antes de executar o cmdlet.

Tipo:SwitchParameter
Aliases:cf
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Description

Especifique uma descrição opcional para o grupo de orquestração para ajudar a identificá-lo.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DisableWildcardHandling

Este parâmetro trata os carateres universais como valores de carateres literais. Não pode combiná-lo com ForceWildcardHandling.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ForceWildcardHandling

Este parâmetro processa carateres universais e pode levar a um comportamento inesperado (não recomendado). Não pode combiná-lo com DisableWildcardHandling.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-MaxLockTimeOutMin

Especifique um valor inteiro para o tempo limite do membro do grupo de orquestração em minutos. Este valor é o limite de tempo para um único dispositivo no grupo instalar as atualizações.

Tipo:Int32
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-MemberResourceIds

Especifique uma matriz de IDs de recursos para os dispositivos adicionarem como membros deste grupo de orquestração. O ID do recurso é um número inteiro, por exemplo, 16777220. É a propriedade ResourceId num dispositivo ou objeto de recurso. Para obter um objeto de dispositivo, utilize os cmdlets Get-CMDevice ou Get-CMResource .

Quando definir o parâmetro OrchestrationType como Sequence, utilize este parâmetro para determinar a ordem.

Tipo:Int32[]
Aliases:MogMembers
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Name

Especifique um nome para o grupo de orquestração.

Tipo:String
Aliases:OrchestrationGroupName
Cargo:0
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-OrchestrationTimeOutMin

Especifique um valor inteiro para o tempo limite do grupo de orquestração em minutos. Este valor é o limite de tempo para todos os membros do grupo instalarem as atualizações.

Tipo:Int32
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-OrchestrationType

Especifique um dos seguintes valores para o tipo de grupo de orquestração:

  • Number: permitir que vários dispositivos atualizem ao mesmo tempo. Utilize esta definição para limitar sempre a um número específico de dispositivos, independentemente do tamanho geral do grupo de orquestração. Para especificar o número de dispositivos, utilize o parâmetro OrchestrationValue .

  • Percentage: permitir que uma percentagem dos dispositivos seja atualizada ao mesmo tempo. Utilize esta definição para permitir uma flexibilidade futura do tamanho do grupo de orquestração. Para especificar a percentagem, utilize o parâmetro OrchestrationValue .

  • Sequence: defina explicitamente a ordem pela qual os dispositivos executam a implementação da atualização de software. A ordem é determinada pelo tipo de IDs de recursos do dispositivo no parâmetro MemberResourceIds .

Tipo:OrchestrationTypeValue
Valores aceitos:Number, Percentage, Sequence
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-OrchestrationValue

Especifique um número inteiro para o número ou percentagem de dispositivos a atualizar ao mesmo tempo. Utilize este parâmetro quando definir o parâmetro OrchestrationType como Number ou Percentage.

Tipo:Int32
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-PostScript

Especifique o script do PowerShell a executar em cada dispositivo após a execução da implementação e o dispositivo reiniciar, se necessário.

Este valor de cadeia é o texto do próprio script. Se tiver um script num ficheiro que pretende utilizar, leia-o primeiro numa variável. Por exemplo, utilize o cmdlet Get-Content incorporado.

Os scripts devem devolver um valor de 0 para êxito. Qualquer valor diferente de zero é considerado uma falha de script. Não pode utilizar um script com parâmetros. O comprimento máximo do script é de 50 000 carateres.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-PostScriptTimeoutSec

Especifique o valor inteiro do tempo permitido em segundos para que o pós-script seja executado antes de exceder o limite de tempo.

Tipo:Int32
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-PreScript

Especifique o script do PowerShell a executar em cada dispositivo antes de a implementação ser executada.

Este valor de cadeia é o texto do próprio script. Se tiver um script num ficheiro que pretende utilizar, leia-o primeiro numa variável. Por exemplo, utilize o cmdlet Get-Content incorporado.

Os scripts devem devolver um valor de 0 para êxito. Qualquer valor diferente de zero é considerado uma falha de script. Não pode utilizar um script com parâmetros. O comprimento máximo do script é de 50 000 carateres.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-PreScriptTimeoutSec

Especifique o valor inteiro do tempo permitido em segundos para que o pré-script seja executado antes de exceder o limite de tempo.

Tipo:Int32
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-SiteCode

Especifique o código do site para este grupo de orquestração e respetivos membros.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-WhatIf

Mostrar o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Tipo:SwitchParameter
Aliases:wi
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

Entradas

None

Saídas

IResultObject

Observações

Este cmdlet devolve um objeto para a classe WMI SMS_MachineOrchestrationGroup.