New-CMOrchestrationGroup
Creare un nuovo gruppo di orchestrazione.
Sintassi
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>] Descrizione
Usare questo cmdlet per creare un nuovo gruppo di orchestrazione.
Usare i gruppi di orchestrazione per controllare meglio la distribuzione degli aggiornamenti software nei dispositivi. Potrebbe essere necessario gestire con attenzione gli aggiornamenti per carichi di lavoro specifici o automatizzare i comportamenti intermedi. Per altre informazioni, vedere Creare e usare gruppi di orchestrazione in Configuration Manager.
Nota
Eseguire i cmdlet di Configuration Manager dall'unità del sito di Configuration Manager, ad esempio PS XYZ:\>. Per altre informazioni, vedere Introduzione.
Esempio
Esempio 1
In questo esempio i parametri del cmdlet vengono innanzitutto inseriti nella variabile parameters . Non è necessario eseguire lo splat dei parametri, ma semplifica la lettura dei parametri per una riga di comando così lunga.
Si presuppone che siano presenti oggetti che i dispositivi devono aggiungere al gruppo di orchestrazione nelle variabili di dispositivo .
Il comando crea un gruppo di orchestrazione con le impostazioni predefinite e script semplici a scopo di test.
$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 @parametersParametri
-Confirm
Richiede la conferma prima di eseguire il cmdlet.
| Tipo: | SwitchParameter |
| Alias: | cf |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-Description
Specificare una descrizione facoltativa per il gruppo di orchestrazione per identificarlo.
| Tipo: | String |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-DisableWildcardHandling
Questo parametro considera i caratteri jolly come valori letterali. Non è possibile combinarlo con ForceWildcardHandling.
| Tipo: | SwitchParameter |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-ForceWildcardHandling
Questo parametro elabora caratteri jolly e può causare un comportamento imprevisto (non consigliato). Non è possibile combinarlo con DisableWildcardHandling.
| Tipo: | SwitchParameter |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-MaxLockTimeOutMin
Specificare un valore intero per il timeout dei membri del gruppo di orchestrazione in minuti. Questo valore è il limite di tempo per l'installazione degli aggiornamenti per un singolo dispositivo nel gruppo.
| Tipo: | Int32 |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-MemberResourceIds
Specificare una matrice di ID risorsa per i dispositivi da aggiungere come membri di questo gruppo di orchestrazione. L'ID risorsa è un numero intero, ad esempio 16777220. Si tratta della proprietà ResourceId in un dispositivo o un oggetto risorsa. Per ottenere un oggetto dispositivo, usare i cmdlet Get-CMDevice o Get-CMResource .
Quando si imposta il parametro OrchestrationType su Sequence, usare questo parametro per determinare l'ordine.
| Tipo: | Int32[] |
| Alias: | MogMembers |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | True |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-Name
Specificare un nome per il gruppo di orchestrazione.
| Tipo: | String |
| Alias: | OrchestrationGroupName |
| Posizione: | 0 |
| Valore predefinito: | None |
| Necessario: | True |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-OrchestrationTimeOutMin
Specificare un valore intero per il timeout del gruppo di orchestrazione in minuti. Questo valore è il limite di tempo per tutti i membri del gruppo per installare gli aggiornamenti.
| Tipo: | Int32 |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-OrchestrationType
Specificare uno dei valori seguenti per il tipo di gruppo di orchestrazione:
Number: consente a un certo numero di dispositivi di eseguire l'aggiornamento contemporaneamente. Usare questa impostazione per limitare sempre a un numero specifico di dispositivi, indipendentemente dalle dimensioni complessive del gruppo di orchestrazione. Per specificare il numero di dispositivi, usare il parametro OrchestrationValue .Percentage: consente l'aggiornamento contemporaneamente di una percentuale dei dispositivi. Usare questa impostazione per consentire una flessibilità futura delle dimensioni del gruppo di orchestrazione. Per specificare la percentuale, usare il parametro OrchestrationValue .Sequence: definire in modo esplicito l'ordine in cui i dispositivi eseguono la distribuzione dell'aggiornamento software. L'ordine è determinato dall'ordinamento degli ID risorsa del dispositivo nel parametro MemberResourceIds .
| Tipo: | OrchestrationTypeValue |
| Valori accettati: | Number, Percentage, Sequence |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | True |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-OrchestrationValue
Specificare un numero intero per il numero o la percentuale di dispositivi da aggiornare contemporaneamente. Usare questo parametro quando si imposta il parametro OrchestrationType su Number o Percentage.
| Tipo: | Int32 |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-PostScript
Specificare lo script di PowerShell da eseguire in ogni dispositivo dopo l'esecuzione della distribuzione e il riavvio del dispositivo, se necessario.
Questo valore stringa è il testo dello script stesso. Se si dispone di uno script in un file che si vuole usare, leggerlo prima in una variabile. Ad esempio, usare il cmdlet Get-Content predefinito.
Gli script devono restituire un valore di per l'esito 0 positivo. Qualsiasi valore diverso da zero viene considerato un errore di script. Non è possibile usare uno script con parametri. La lunghezza massima dello script è di 50.000 caratteri.
| Tipo: | String |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-PostScriptTimeoutSec
Specificare il valore intero per il tempo consentito in secondi per l'esecuzione del post-script prima del timeout.
| Tipo: | Int32 |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-PreScript
Specificare lo script di PowerShell da eseguire in ogni dispositivo prima dell'esecuzione della distribuzione.
Questo valore stringa è il testo dello script stesso. Se si dispone di uno script in un file che si vuole usare, leggerlo prima in una variabile. Ad esempio, usare il cmdlet Get-Content predefinito.
Gli script devono restituire un valore di per l'esito 0 positivo. Qualsiasi valore diverso da zero viene considerato un errore di script. Non è possibile usare uno script con parametri. La lunghezza massima dello script è di 50.000 caratteri.
| Tipo: | String |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-PreScriptTimeoutSec
Specificare il valore intero per il tempo consentito in secondi per l'esecuzione del pre-script prima del timeout.
| Tipo: | Int32 |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-SiteCode
Specificare il codice del sito per questo gruppo di orchestrazione e i relativi membri.
| Tipo: | String |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | True |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-WhatIf
Mostra cosa accade se viene eseguito il cmdlet. Il cmdlet non viene eseguito.
| Tipo: | SwitchParameter |
| Alias: | wi |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
Input
None
Output
IResultObject
Note
Questo cmdlet restituisce un oggetto per la classe WMI SMS_MachineOrchestrationGroup .