Partilhar via

New-CMOrchestrationGroup

  • Referência
Módulo:
ConfigurationManager

Crie um novo grupo de orquestração.

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

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

Use grupos de orquestração para controlar melhor a implantação de atualizações de software em dispositivos. Talvez seja 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 em Configuration Manager.

Observação

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

Exemplos

Exemplo 1

Este exemplo primeiro coloca os parâmetros de cmdlet na variável de parâmetros . Não é necessário emendar os parâmetros, apenas facilita a leitura dos parâmetros para uma linha de comando tão longa.

Ele pressupõe que você tenha objetos para os dispositivos adicionarem ao grupo de orquestração nas variáveis de dispositivo .

O comando cria um grupo de orquestração com as configurações padrão 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.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Description

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DisableWildcardHandling

Esse parâmetro trata caracteres curinga como valores de caractere literal. Você não pode combiná-lo com ForceWildcardHandling.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ForceWildcardHandling

Esse parâmetro processa caracteres curinga e pode levar a um comportamento inesperado (não recomendado). Você não pode combiná-lo com DisableWildcardHandling.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-MaxLockTimeOutMin

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

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-MemberResourceIds

Especifique uma matriz de IDs de recursos para os dispositivos a serem adicionados como membros desse grupo de orquestração. A ID do recurso é um 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 como Sequence, use esse parâmetro para determinar a ordem.

Type:Int32[]
Aliases:MogMembers
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Name

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

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

-OrchestrationTimeOutMin

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

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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. Use essa configuração para sempre limitar a um número específico de dispositivos, qualquer que seja o tamanho geral do grupo de orquestração. Para especificar o número de dispositivos, use o parâmetro OrchestrationValue .

  • 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 o percentual, use o parâmetro OrchestrationValue .

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

Type:OrchestrationTypeValue
Accepted values:Number, Percentage, Sequence
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-OrchestrationValue

Especifique um inteiro para o número ou porcentagem de dispositivos a serem atualizados ao mesmo tempo. Use esse parâmetro ao definir o parâmetro OrchestrationType como Number ou Percentage.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PostScript

Especifique o script do PowerShell a ser executado em cada dispositivo após a execução da implantação e a reinicialização do dispositivo, se necessário.

Esse valor de cadeia de caracteres é o texto do script em si. Se você tiver um script em um arquivo que deseja usar, primeiro leia-o em uma variável. Por exemplo, use o cmdlet get-content interno.

Os scripts devem retornar um valor de 0 para o sucesso. Qualquer valor não 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.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PostScriptTimeoutSec

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

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PreScript

Especifique o script do PowerShell a ser executado em cada dispositivo antes da execução da implantação.

Esse valor de cadeia de caracteres é o texto do script em si. Se você tiver um script em um arquivo que deseja usar, primeiro leia-o em uma variável. Por exemplo, use o cmdlet get-content interno.

Os scripts devem retornar um valor de 0 para o sucesso. Qualquer valor não 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.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PreScriptTimeoutSec

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

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SiteCode

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

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Entradas

None

Saídas

IResultObject

Observações

Este cmdlet retorna um objeto para a classe WMI SMS_MachineOrchestrationGroup .