New-CMOrchestrationGroup
Cree un nuevo grupo de orquestación.
Sintaxis
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 crear un nuevo grupo de orquestación.
Use grupos de orquestación para controlar mejor la implementación de actualizaciones de software en dispositivos. Es posible que tenga que administrar cuidadosamente las actualizaciones de cargas de trabajo específicas o automatizar los comportamientos entre ellos. Para obtener más información, vea Crear y usar grupos de orquestación en Configuration Manager.
Nota:
Ejecute cmdlets de Configuration Manager desde la unidad de sitio de Configuration Manager, por ejemplo PS XYZ:\>. Para obtener más información, consulte Introducción.
Ejemplos
Ejemplo 1
En este ejemplo, primero se salpican los parámetros del cmdlet en la variable parameters . No es necesario salpicar los parámetros, simplemente facilita la lectura de los parámetros de una línea de comandos tan larga.
Se supone que tiene objetos para que los dispositivos se agreguen al grupo de orquestación en las variables de dispositivo .
El comando crea un grupo de orquestación con la configuración predeterminada y scripts simples con fines de prueba.
$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 @parametersParámetros
-Confirm
Solicitará confirmación antes de ejecutar el cmdlet.
| Tipo: | SwitchParameter |
| Alias: | cf |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-Description
Especifique una descripción opcional para el grupo de orquestación para ayudar a identificarlo.
| Tipo: | String |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-DisableWildcardHandling
Este parámetro trata los caracteres comodín como valores de caracteres literales. No se puede combinar con ForceWildcardHandling.
| Tipo: | SwitchParameter |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-ForceWildcardHandling
Este parámetro procesa caracteres comodín y puede provocar un comportamiento inesperado (no recomendado). No se puede combinar con DisableWildcardHandling.
| Tipo: | SwitchParameter |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-MaxLockTimeOutMin
Especifique un valor entero para el tiempo de espera del miembro del grupo de orquestación en minutos. Este valor es el límite de tiempo para que un único dispositivo del grupo instale las actualizaciones.
| Tipo: | Int32 |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-MemberResourceIds
Especifique una matriz de identificadores de recursos para que los dispositivos se agreguen como miembros de este grupo de orquestación. El identificador de recurso es un entero, por ejemplo, 16777220. Es la propiedad ResourceId en un dispositivo o objeto de recurso. Para obtener un objeto de dispositivo, use los cmdlets Get-CMDevice o Get-CMResource .
Cuando establezca el parámetro OrchestrationType en Sequence, use este parámetro para determinar el orden.
| Tipo: | Int32[] |
| Alias: | MogMembers |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | True |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-Name
Especifique un nombre para el grupo de orquestaciones.
| Tipo: | String |
| Alias: | OrchestrationGroupName |
| Posición: | 0 |
| Valor predeterminado: | None |
| Requerido: | True |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-OrchestrationTimeOutMin
Especifique un valor entero para el tiempo de espera del grupo de orquestación en minutos. Este valor es el límite de tiempo para que todos los miembros del grupo instalen las actualizaciones.
| Tipo: | Int32 |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-OrchestrationType
Especifique uno de los siguientes valores para el tipo de grupo de orquestación:
Number: permite que varios de los dispositivos se actualicen al mismo tiempo. Use esta configuración para limitar siempre a un número específico de dispositivos, sea cual sea el tamaño general del grupo de orquestación. Para especificar el número de dispositivos, use el parámetro OrchestrationValue .Percentage: permite que un porcentaje de los dispositivos se actualice al mismo tiempo. Use esta configuración para permitir una flexibilidad futura del tamaño del grupo de orquestación. Para especificar el porcentaje, use el parámetro OrchestrationValue .Sequence: defina explícitamente el orden en el que los dispositivos ejecutan la implementación de actualizaciones de software. El orden viene determinado por el tipo de identificadores de recurso de dispositivo en el parámetro MemberResourceIds .
| Tipo: | OrchestrationTypeValue |
| Valores aceptados: | Number, Percentage, Sequence |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | True |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-OrchestrationValue
Especifique un entero para el número o porcentaje de dispositivos que se van a actualizar al mismo tiempo. Use este parámetro cuando establezca el parámetro OrchestrationType en Number o Percentage.
| Tipo: | Int32 |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-PostScript
Especifique el script de PowerShell que se ejecutará en cada dispositivo después de que se ejecute la implementación y se reinicie el dispositivo, si es necesario.
Este valor de cadena es el texto del propio script. Si tiene un script en un archivo que desea usar, léelo primero en una variable. Por ejemplo, use el cmdlet Get-Content integrado.
Los scripts deben devolver un valor de 0 para que se realice correctamente. Cualquier valor distinto de cero se considera un error de script. No se puede usar un script con parámetros. La longitud máxima del script es de 50 000 caracteres.
| Tipo: | String |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-PostScriptTimeoutSec
Especifique el valor entero del tiempo permitido en segundos para que el script posterior se ejecute antes de agotar el tiempo de espera.
| Tipo: | Int32 |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-PreScript
Especifique el script de PowerShell que se ejecutará en cada dispositivo antes de que se ejecute la implementación.
Este valor de cadena es el texto del propio script. Si tiene un script en un archivo que desea usar, léelo primero en una variable. Por ejemplo, use el cmdlet Get-Content integrado.
Los scripts deben devolver un valor de 0 para que se realice correctamente. Cualquier valor distinto de cero se considera un error de script. No se puede usar un script con parámetros. La longitud máxima del script es de 50 000 caracteres.
| Tipo: | String |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-PreScriptTimeoutSec
Especifique el valor entero del tiempo permitido en segundos para que se ejecute el script anterior antes de agotar el tiempo de espera.
| Tipo: | Int32 |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-SiteCode
Especifique el código de sitio para este grupo de orquestación y sus miembros.
| Tipo: | String |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | True |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-WhatIf
Muestra lo que ocurriría si se ejecuta el cmdlet. El cmdlet no se ejecuta.
| Tipo: | SwitchParameter |
| Alias: | wi |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
Entradas
None
Salidas
IResultObject
Notas
Este cmdlet devuelve un objeto para la clase WMI de SMS_MachineOrchestrationGroup .