Modificare un'immagine di avvio del sistema operativo.
\n","uid":"ConfigurationManager.Set-CMBootImage"}],"ocv-translation-feedback":true},"_xrefmap":{"ConfigurationManager":{"href":"./","monikerGroup":"f98fea35b6ac2b0f56c6ee5ec06ffce9","name":"ConfigurationManager","schemaType":"PowershellModule","uid":"ConfigurationManager"},"ConfigurationManager.Set-CMBootImage":{"href":"set-cmbootimage","monikerGroup":"f98fea35b6ac2b0f56c6ee5ec06ffce9","name":"Set-CMBootImage","schemaType":"PowershellCmdlet","summary":"Modificare un'immagine di avvio del sistema operativo.
\n","uid":"ConfigurationManager.Set-CMBootImage"}},"description":"Usare questo cmdlet per modificare un'immagine di avvio del sistema operativo. Le immagini di avvio sono immagini Windows Preinstallation Environment (Windows PE) in cui si avvia un computer client prima di installare un sistema operativo.
\nÈ possibile aggiungere driver di dispositivo a un'immagine di avvio o modificarne le proprietà. Prima di aggiungere un nuovo driver di dispositivo, è necessario importare il driver nel catalogo dei driver di Configuration Manager e abilitarlo.
\nOgni versione di Configuration Manager supporta una versione specifica di Windows Assessment and Deployment Kit (Windows ADK). Puoi usare o personalizzare le immagini di avvio quando sono basate su una versione di Windows PE della versione supportata di Windows ADK.
\nPer altre informazioni, vedere Gestire le immagini di avvio con 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.
Questo comando ottiene un'immagine di avvio in base all'ID pacchetto e quindi la rinomina.
\n","title":"Esempio 1: Rinominare un'immagine di avvio"},{"code":"Set-CMBootImage -Name \"Custom boot image (x64)\" -Version \"Contoso v2.1\" -Description \"Managed by jqpublic\"","description":"","summary":"Questo comando ottiene un'immagine di avvio in base al nome e quindi aggiunge una versione e una descrizione.
\n","title":"Esempio 2: Impostare proprietà descrittive"},{"code":"Set-CMBootimage -Id \"CM100004\" -InputLocale \"ru-ru\"","description":"","summary":"Nell'esempio seguente il layout di tastiera predefinito dell'immagine di avvio viene impostato sulla lingua russa (Russia). Identifica l'immagine di avvio in base al relativo ID.
\n","title":"Esempio 3: Impostare il layout della tastiera"},{"code":"$netfxOC = Get-CMWinPEOptionalComponentInfo -Architecture 'x64' -Name 'WinPE-NetFX' -LanguageId 1033\n$pwshOC = Get-CMWinPEOptionalComponentInfo -Architecture 'x64' -Name 'WinPE-PowerShell' -LanguageId 1033\n$OCs = @($netfxOC, $pwshOC)\n\nSet-CMBootImage -Id 'XYZ00556' -AddOptionalComponent $OCs","description":"","summary":"Questo esempio ottiene i componenti facoltativi di .NET e PowerShell e li aggiunge all'immagine di avvio.
\n","title":"Esempio 4: Aggiungere componenti facoltativi"}],"inputs":[{"description":"","name":"Microsoft.ConfigurationManagement.ManagementProvider.IResultObject\n"}],"links":[{"href":"get-cmbootimage","text":"Get-CMBootImage"},{"href":"new-cmbootimage","text":"New-CMBootImage"},{"href":"remove-cmbootimage","text":"Remove-CMBootImage"},{"href":"get-cmwinpeoptionalcomponentinfo","text":"Get-CMWinPEOptionalComponentInfo"},{"href":"/mem/configmgr/osd/get-started/manage-boot-images","text":"Gestire le immagini di avvio con Configuration Manager"}],"module":"ConfigurationManager","name":"Set-CMBootImage","notes":"","outputs":[{"description":"","name":"System.Object\n"}],"parameters":[{"aliases":"AddOptionalComponents","defaultValue":"None","description":"Specificare una matrice di oggetti componente facoltativi da aggiungere all'immagine di avvio. Per ottenere questo oggetto, usare il cmdlet Get-CMWinPEOptionalComponentInfo .
\nI componenti seguenti sono comunemente usati:
\nPer altre informazioni, vedere Gestire le immagini di avvio - Componenti facoltativi.
\n","name":"AddOptionalComponent","parameterValueGroup":"","position":"Named","type":"IResultObject[]
\n"},{"aliases":"","defaultValue":"None","description":"Specificare il percorso del file di rete di un file di immagine di sfondo personalizzato da usare in Windows PE.
\n","name":"BackgroundBitmapPath","parameterValueGroup":"","position":"Named","type":"String\n"},{"aliases":"cf","defaultValue":"False","description":"Richiede la conferma prima di eseguire il cmdlet.
\n","name":"Confirm","parameterValueGroup":"","position":"Named","type":"SwitchParameter\n"},{"aliases":"CopyToPackageShareOnDistributionPoints","defaultValue":"None","description":"I client possono sempre scaricare un'immagine di avvio da un punto di distribuzione. Se si imposta questo parametro su $true, il sito lo rende disponibile tramite una condivisione di rete denominata nei punti di distribuzione. Usare CustomPackageShareName per specificare un nome di condivisione personalizzato.
\nQuando si abilita questa opzione, è necessario più spazio nei punti di distribuzione. Si applica a tutti i punti di distribuzione a cui si distribuisce questa immagine di avvio.
\n","name":"CopyToPackageShareOnDistributionPoint","parameterValueGroup":"","position":"Named","type":"Boolean\n"},{"aliases":"","defaultValue":"None","description":"Se si abilita CopyToPackageShareOnDistributionPoint, è possibile usare questo parametro per personalizzare il nome della condivisione. La lunghezza massima è di 127 caratteri e non può includere i caratteri seguenti: " / [ ] : | < > + = ; , ? *. È possibile specificare un nome di condivisione e un nome di cartella, ma il massimo per ognuno è 80 caratteri. Ad esempio, ShareName\\FolderName.
Impostare questo parametro su $true per rendere disponibile questa immagine di avvio da un punto di distribuzione abilitato per PXE. Per altre informazioni, vedere Usare PXE per distribuire Windows in rete.
\n","name":"DeployFromPxeDistributionPoint","parameterValueGroup":"","position":"Named","type":"Boolean\n"},{"aliases":"","defaultValue":"None","description":"Specificare una descrizione facoltativa di un'immagine di avvio per identificarla.
\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":"DisconnectUsersFromDistributionPoints","defaultValue":"None","description":"Questa opzione è deprecata. Imposta la proprietà ForcedDisconnectEnabled dell'immagine di avvio.
\n","name":"DisconnectUserFromDistributionPoint","parameterValueGroup":"","position":"Named","type":"Boolean\n"},{"aliases":"DisconnectUsersFromDistributionPointsMinutes","defaultValue":"None","description":"Questa opzione è deprecata. Imposta la proprietà ForcedDisconnectDelay dell'immagine di avvio.
\n","name":"DisconnectUserFromDistributionPointMins","parameterValueGroup":"","position":"Named","type":"UInt32\n"},{"aliases":"DisconnectUsersFromDistributionPointsRetries","defaultValue":"None","description":"Questa opzione è deprecata. Imposta la proprietà ForcedDisconnectNumRetries dell'immagine di avvio.
\n","name":"DisconnectUserFromDistributionPointRetryCount","parameterValueGroup":"","position":"Named","type":"UInt32\n"},{"aliases":"","defaultValue":"None","description":"Usare questo parametro per aggiornare i punti di distribuzione in base a una pianificazione. Per ottenere un oggetto pianificazione, usare il cmdlet New-CMSchedule .
\n","name":"DistributionPointUpdateSchedule","parameterValueGroup":"","position":"Named","type":"IResultObject\n"},{"aliases":"","defaultValue":"None","description":"Impostare questo parametro su $true per abilitare la replica differenziale binaria.Set this parameter to $true to enable binary differential replication (BDR). Per altre informazioni, vedere Concetti fondamentali per la gestione dei contenuti in Configuration Manager.
\n","name":"EnableBinaryDeltaReplication","parameterValueGroup":"","position":"Named","type":"Boolean\n"},{"aliases":"","defaultValue":"None","description":"Solo negli ambienti di test non di produzione è possibile impostare questo parametro su $true per abilitare il supporto dei comandi. Quando un dispositivo viene avviato in questa immagine, è possibile premere F8 per aprire un prompt dei comandi amministrativo. Questa opzione è utile per la risoluzione dei problemi durante il test della distribuzione. L'uso di questa impostazione in una distribuzione di produzione non è consigliato a causa di problemi di sicurezza.
\n","name":"EnableCommandSupport","parameterValueGroup":"","position":"Named","type":"Boolean\n"},{"aliases":"","defaultValue":"None","description":"Impostare questo parametro su $true per abilitare un comando di preavvio. Questa riga di comando viene eseguita prima dell'avvio della sequenza di attività.
\nConfigurare anche i parametri seguenti: IncludeFilesForPrestart, PrestartCommandLine, PrestartIncludeFilesDirectory.
\n","name":"EnablePrestartCommand","parameterValueGroup":"","position":"Named","type":"Boolean\n"},{"aliases":"","defaultValue":"None","description":"Eseguire il comando senza richiedere conferma.
\n","name":"Force","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":"PackageId","defaultValue":"None","description":"Specificare un ID immagine di avvio da configurare. Questo valore è un ID pacchetto standard, ad esempio: XYZ00002.
Se si abilita EnablePrestartCommand, usare questo parametro se il comando di preavvio richiede l'esecuzione di altri file. Usare quindi il parametro PrestartIncludeFilesDirectory per specificare il percorso dei file da includere.
\nAd esempio, se si vuole eseguire uno script batch, usare questa opzione per includere il file di script.
\n","name":"IncludeFilesForPrestart","parameterValueGroup":"","position":"Named","type":"Boolean\n"},{"aliases":"","defaultValue":"None","description":"Usare questo parametro per configurare il layout di tastiera predefinito per un'immagine di avvio. Specificare il tag di lingua. Ad esempio, per impostare le impostazioni locali di input su Russo (Russia), specificare la stringa ru-ru. Per altre informazioni, vedere [MS-LCID]: Informazioni di riferimento sull'identificatore LCID (Windows Language Code Identifier).
Specificare un oggetto immagine di avvio da configurare. Per ottenere questo oggetto, usare il cmdlet Get-CMBootImage .
\n","isRequired":true,"name":"InputObject","parameterValueGroup":"","pipelineInput":true,"position":"Named","type":"IResultObject\n"},{"aliases":"","defaultValue":"None","description":"Specificare il nome di un'immagine di avvio da configurare.
\n","isRequired":true,"name":"Name","parameterValueGroup":"","position":"Named","type":"String\n"},{"aliases":"","defaultValue":"None","description":"Specificare un nuovo nome per l'immagine di avvio.
\n","name":"NewName","parameterValueGroup":"","position":"Named","type":"String\n"},{"aliases":"","defaultValue":"None","description":"Aggiungere questo parametro per restituire un oggetto che rappresenta l'elemento con cui si sta lavorando. Per impostazione predefinita, questo cmdlet potrebbe non generare alcun output.
\n","name":"PassThru","parameterValueGroup":"","position":"Named","type":"SwitchParameter\n"},{"aliases":"ImagePath","defaultValue":"None","description":"Specificare il percorso di rete dell'immagine Windows PE usata da questa immagine di avvio. Non è possibile modificare il percorso per le immagini di avvio predefinite.
\n","name":"Path","parameterValueGroup":"","position":"Named","type":"String\n"},{"aliases":"","defaultValue":"None","description":"Se non si vuole che il contenuto di questo pacchetto scada dalla cache client per fare spazio ad altri contenuti, impostare questo parametro su $true per renderlo permanente nella cache client.
\n","name":"PersistContentInCache","parameterValueGroup":"","position":"Named","type":"Boolean\n"},{"aliases":"","defaultValue":"None","description":"Specificare il comportamento quando si abilita un punto di distribuzione per il contenuto pre-installato:
\nManualCopy: copiare manualmente il contenuto di questo pacchetto nel punto di distribuzioneDownloadDelta: scaricare solo le modifiche al contenuto nel punto di distribuzioneOnDemand: scaricare automaticamente il contenuto quando i pacchetti vengono assegnati ai punti di distribuzionePer altre informazioni, vedere Usare il contenuto pre-installato.
\n","name":"PrestageBehavior","parameterValueGroup":"ManualCopy, DownloadDelta, OnDemand","position":"Named","type":"PrestageBehavior\n"},{"aliases":"CommandLine","defaultValue":"None","description":"Se si abilita EnablePrestartCommand, usare questo parametro per specificare la riga di comando da eseguire. La lunghezza massima è di 4096 caratteri.
\nSe la riga di comando richiede file non presenti in Windows PE, usare i parametri IncludeFilesForPrestart e PrestartIncludeFilesDirectory .
\n","name":"PrestartCommandLine","parameterValueGroup":"","position":"Named","type":"String\n"},{"aliases":"","defaultValue":"None","description":"Se abiliti EnablePrestartCommand e IncludeFilesForPrestart, usa questo parametro per specificare il percorso di rete dei file da includere nell'immagine di avvio.
\n","name":"PrestartIncludeFilesDirectory","parameterValueGroup":"","position":"Named","type":"String\n"},{"aliases":"","defaultValue":"None","description":"Specificare l'ordine in cui il sito invia il contenuto ad altri siti e ai punti di distribuzione del sito.
\nIl sito invia contenuto con priorità elevata prima dei pacchetti con priorità media o bassa. I pacchetti con priorità uguale vengono inviati nell'ordine in cui vengono creati.
\n","name":"Priority","parameterValueGroup":"High, Medium, Low","position":"Named","type":"Priority\n"},{"aliases":"ReloadImage","defaultValue":"None","description":"Si applica alla versione 2006 e successive. Se le versioni dei componenti di Windows ADK nell'immagine di avvio non sono aggiornate, aggiungere questo parametro per ricaricare l'immagine di avvio con la versione corrente di Windows PE da Windows ADK. Per altre informazioni, vedere Aggiornare i punti di distribuzione con l'immagine di avvio.
\n","name":"Reload","parameterValueGroup":"","position":"Named","type":"SwitchParameter\n"},{"aliases":"RemoveOptionalComponents","defaultValue":"None","description":"Specificare una matrice di oggetti componente facoltativi da rimuovere dall'immagine di avvio. Per ottenere questo oggetto, usare il cmdlet Get-CMWinPEOptionalComponentInfo .
\nNon rimuovere i componenti seguenti, richiesti da Configuration Manager:
\nIResultObject[]
\n"},{"aliases":"","defaultValue":"None","description":"Configurare lo spazio scratch di Windows PE, ovvero l'archiviazione temporanea (unità RAM) usata da WinPE. Ad esempio, quando un'applicazione viene eseguita all'interno di WinPE e deve scrivere file temporanei, WinPE reindirizza i file allo spazio di lavoro in memoria per simulare la presenza di un disco rigido. Per impostazione predefinita, questa quantità è di 512 MB per i dispositivi con più di 1 GB di RAM, in caso contrario il valore predefinito è 32 MB.
\n","name":"ScratchSpace","parameterValueGroup":"32, 64, 128, 256, 512","position":"Named","type":"UInt32\n"},{"aliases":"SendToPreferredDistributionPoints","defaultValue":"None","description":"Se si vuole abilitare la distribuzione del contenuto su richiesta nei punti di distribuzione preferiti, impostare questo parametro su $true. Quando si abilita questa impostazione, se un client richiede il contenuto per il pacchetto e il contenuto non è disponibile in alcun punto di distribuzione, il punto di gestione distribuisce il contenuto. Per altre informazioni, vedere Distribuzione del contenuto su richiesta.
\n","name":"SendToPreferredDistributionPoint","parameterValueGroup":"","position":"Named","type":"Boolean\n"},{"aliases":"","defaultValue":"None","description":"Specificare la versione dell'immagine di avvio. Questo valore non è la versione del sistema operativo, ma una stringa gestita.
\n","name":"Version","parameterValueGroup":"","position":"Named","type":"String\n"},{"aliases":"wi","defaultValue":"False","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":"Modificare un'immagine di avvio del sistema operativo.
\n","syntaxes":["Set-CMBootImage [-AddOptionalComponentModificare un'immagine di avvio del sistema operativo.
\n","uid":"ConfigurationManager.Set-CMBootImage"}],"canonical_url":"https://learn.microsoft.com/it-it/powershell/module/configurationmanager/set-cmbootimage?view=sccm-ps","_op_canonicalUrl":"https://learn.microsoft.com/it-it/powershell/module/configurationmanager/set-cmbootimage?view=sccm-ps"},"pageMetadata":"Usare questo cmdlet per modificare un'immagine di avvio del sistema operativo. Le immagini di avvio sono immagini Windows Preinstallation Environment (Windows PE) in cui si avvia un computer client prima di installare un sistema operativo.\nÈ possibile aggiungere driver di dispositivo a un'immagine di avvio o modificarne le proprietà. Prima di aggiungere un nuovo driver di dispositivo, è necessario importare il driver nel catalogo dei driver di Configuration Manager e abilitarlo.
\nOgni versione di Configuration Manager supporta una versione specifica di Windows Assessment and Deployment Kit (Windows ADK). Puoi usare o personalizzare le immagini di avvio quando sono basate su una versione di Windows PE della versione supportata di Windows ADK.
\nPer altre informazioni, vedere Gestire le immagini di avvio con 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.