Configurare un gruppo di orchestrazione.
\n","uid":"ConfigurationManager.Set-CMOrchestrationGroup"}],"ocv-translation-feedback":true},"_xrefmap":{"ConfigurationManager":{"href":"./","monikerGroup":"f98fea35b6ac2b0f56c6ee5ec06ffce9","name":"ConfigurationManager","schemaType":"PowershellModule","uid":"ConfigurationManager"},"ConfigurationManager.Set-CMOrchestrationGroup":{"href":"set-cmorchestrationgroup","monikerGroup":"f98fea35b6ac2b0f56c6ee5ec06ffce9","name":"Set-CMOrchestrationGroup","schemaType":"PowershellCmdlet","summary":"Configurare un gruppo di orchestrazione.
\n","uid":"ConfigurationManager.Set-CMOrchestrationGroup"}},"description":"Usare questo cmdlet per configurare un gruppo di orchestrazione.
\nUsare 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.
\nNota
\nEseguire i cmdlet di Configuration Manager dall'unità del sito di Configuration Manager, ad esempio PS XYZ:\\>. Per altre informazioni, vedere Introduzione.
In questo esempio viene illustrato come eseguire un tipo a livello di codice dei membri esistenti. Se l'appartenenza al gruppo di orchestrazione non cambia, usa il processo generale seguente:
\nQuesto esempio usa Get-CMDevice per ottenere altre informazioni, ma è possibile sostituirlo con qualsiasi cmdlet che usa l'ID risorsa del dispositivo come input. È anche possibile sostituire il meccanismo di ordinamento con un'altra funzione.
\n","summary":"Questo esempio usa innanzitutto il cmdlet Get-CMOrchestrationGroup per ottenere un oggetto per il gruppo di orchestrazione denominato server IT. Archivia questo oggetto nella variabile og .
\nIl comando successivo definisce una matrice denominata devices. Esegue il ciclo di ogni membro del gruppo di orchestrazione dei server IT ($og.MOGMembers) e passa l'ID del membro al cmdlet Get-CMDevice . L'oggetto dispositivo restituito viene aggiunto alla matrice devices .
Il comando successivo ordina la matrice in base al nome del dispositivo e restituisce gli ID risorsa del dispositivo nella variabile sortedID .
\nEsegue quindi lo splat dei parametri del cmdlet nella variabile parameters . Non è necessario eseguire lo splat dei parametri, ma semplifica la lettura dei parametri per una riga di comando così lunga.
\nL'ultimo comando configura il gruppo di orchestrazione specificato con un ordine di sequenza definito. Usa il parametro MemberResourceIds per impostare la sequenza, non aggiungere o rimuovere membri.
\n","title":"Esempio 1: Modificare il tipo e specificare la sequenza"},{"code":"$postScript - Get-Content -Path \"D:\\Scripts\\OG\\Post1.ps1\"\nSet-CMOrchestrationGroup -InputObject $og -PostScript $postScript","description":"","summary":"Questo esempio usa il cmdlet Get-Content predefinito per leggere il testo dello script da un file locale. Archivia il testo dello script nella variabile postScript . Il secondo comando configura il gruppo di orchestrazione con il nuovo post-script.
\n","title":"Esempio 2: Ottenere il contenuto dello script da un file"}],"inputs":[{"description":"","name":"Microsoft.ConfigurationManagement.ManagementProvider.IResultObject\n"}],"links":[{"href":"get-cmorchestrationgroup","text":"Get-CMOrchestrationGroup"},{"href":"invoke-cmorchestrationgroup","text":"Invoke-CMOrchestrationGroup"},{"href":"new-cmorchestrationgroup","text":"New-CMOrchestrationGroup"},{"href":"remove-cmorchestrationgroup","text":"Remove-CMOrchestrationGroup"},{"href":"/mem/configmgr/sum/deploy-use/orchestration-groups","text":"Informazioni sui gruppi di orchestrazione in Configuration Manager"}],"module":"ConfigurationManager","name":"Set-CMOrchestrationGroup","notes":"Questo cmdlet restituisce un oggetto per la classe WMI SMS_MachineOrchestrationGroup .
\n","outputs":[{"description":"","name":"IResultObject\n"}],"parameters":[{"aliases":"cf","defaultValue":"None","description":"Richiede la conferma prima di eseguire il cmdlet.
\n","name":"Confirm","parameterValueGroup":"","position":"Named","type":"SwitchParameter\n"},{"aliases":"","defaultValue":"None","description":"Specificare una descrizione facoltativa per il gruppo di orchestrazione per identificarlo.
\n","name":"Description","parameterValueGroup":"","position":"Named","type":"String\n"},{"aliases":"","defaultValue":"None","description":"Questo parametro considera i caratteri jolly come valori letterali. Non è possibile combinarlo con ForceWildcardHandling.
\n","name":"DisableWildcardHandling","parameterValueGroup":"","position":"Named","type":"SwitchParameter\n"},{"aliases":"","defaultValue":"None","description":"Questo parametro elabora caratteri jolly e può causare un comportamento imprevisto (non consigliato). Non è possibile combinarlo con DisableWildcardHandling.
\n","name":"ForceWildcardHandling","parameterValueGroup":"","position":"Named","type":"SwitchParameter\n"},{"aliases":"MOGID","defaultValue":"None","description":"Specificare l'ID del gruppo di orchestrazione da configurare. Questo valore è la proprietà MOGID , che è un numero intero. Ad esempio, 16777217.
Specificare un oggetto da configurare per il gruppo di orchestrazione. Per ottenere questo oggetto, usare il cmdlet Get-CMOrchestrationGroup .
\n","isRequired":true,"name":"InputObject","parameterValueGroup":"","pipelineInput":true,"position":"0","type":"IResultObject\n"},{"aliases":"","defaultValue":"None","description":"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.
\n","name":"MaxLockTimeOutMin","parameterValueGroup":"","position":"Named","type":"Int32\n"},{"aliases":"MogMembers","defaultValue":"None","description":"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.
Int32[]
\n"},{"aliases":"OrchestrationGroupName","defaultValue":"None","description":"Specificare il nome del gruppo di orchestrazione da configurare.
\n","isRequired":true,"name":"Name","parameterValueGroup":"","position":"0","type":"String\n"},{"aliases":"","defaultValue":"None","description":"Specificare un nuovo nome per questo gruppo di orchestrazione. Usare questo parametro per rinominare il gruppo di orchestrazione.
\n","name":"NewName","parameterValueGroup":"","position":"Named","type":"String\n"},{"aliases":"","defaultValue":"None","description":"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.
\n","name":"OrchestrationTimeOutMin","parameterValueGroup":"","position":"Named","type":"Int32\n"},{"aliases":"","defaultValue":"None","description":"Specificare uno dei valori seguenti per il tipo di gruppo di orchestrazione:
\n\n 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 .
\n 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 .
\n 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 .
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.
Specificare lo script di PowerShell da eseguire in ogni dispositivo dopo l'esecuzione della distribuzione e il riavvio del dispositivo, se necessario.
\nQuesto 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.
\nGli 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.
Specificare il valore intero per il tempo consentito in secondi per l'esecuzione del post-script prima del timeout.
\n","name":"PostScriptTimeoutSec","parameterValueGroup":"","position":"Named","type":"Int32\n"},{"aliases":"","defaultValue":"None","description":"Specificare lo script di PowerShell da eseguire in ogni dispositivo prima dell'esecuzione della distribuzione.
\nQuesto 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.
\nGli 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.
Specificare il valore intero per il tempo consentito in secondi per l'esecuzione del pre-script prima del timeout.
\n","name":"PreScriptTimeoutSec","parameterValueGroup":"","position":"Named","type":"Int32\n"},{"aliases":"wi","defaultValue":"None","description":"Mostra cosa accade se viene eseguito il cmdlet. Il cmdlet non viene eseguito.
\n","name":"WhatIf","parameterValueGroup":"","position":"Named","type":"SwitchParameter\n"}],"schema":"PowershellCmdlet","summary":"Configurare un gruppo di orchestrazione.
\n","syntaxes":["Set-CMOrchestrationGroup [-InputObject]Configurare un gruppo di orchestrazione.
\n","uid":"ConfigurationManager.Set-CMOrchestrationGroup"}],"canonical_url":"https://learn.microsoft.com/it-it/powershell/module/configurationmanager/set-cmorchestrationgroup?view=sccm-ps","_op_canonicalUrl":"https://learn.microsoft.com/it-it/powershell/module/configurationmanager/set-cmorchestrationgroup?view=sccm-ps"},"pageMetadata":"Usare questo cmdlet per configurare un gruppo di orchestrazione.\nUsare 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.
\nNota
\nEseguire i cmdlet di Configuration Manager dall'unità del sito di Configuration Manager, ad esempio PS XYZ:\\>. Per altre informazioni, vedere Introduzione.