New-CMOrchestrationGroup
Cree un nuevo grupo de orquestación.
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 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 Configuration Manager, por ejemploPS 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 @parameters
Parámetros
-Confirm
Solicitará confirmación antes de ejecutar el cmdlet.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Description
Especifique una descripción opcional para el grupo de orquestación para ayudar a identificarlo.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DisableWildcardHandling
Este parámetro trata los caracteres comodín como valores de caracteres literales. No se puede combinar con ForceWildcardHandling.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ForceWildcardHandling
Este parámetro procesa caracteres comodín y puede provocar un comportamiento inesperado (no recomendado). No se puede combinar con DisableWildcardHandling.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Type: | Int32[] |
Aliases: | MogMembers |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Name
Especifique un nombre para el grupo de orquestaciones.
Type: | String |
Aliases: | OrchestrationGroupName |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 .
Type: | OrchestrationTypeValue |
Accepted values: | Number, Percentage, Sequence |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | 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
.
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SiteCode
Especifique el código de sitio para este grupo de orquestación y sus miembros.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
Muestra lo que ocurriría si se ejecuta el cmdlet. El cmdlet no se ejecuta.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Entradas
None
Salidas
IResultObject
Notas
Este cmdlet devuelve un objeto para la clase WMI de SMS_MachineOrchestrationGroup .
Vínculos relacionados
Comentarios
https://aka.ms/ContentUserFeedback.
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea:Enviar y ver comentarios de