Set-CMBootImage
Modificare un'immagine di avvio del sistema operativo.
Sintassi
Set-CMBootImage
[-AddOptionalComponent <IResultObject[]>]
[-BackgroundBitmapPath <String>]
[-CopyToPackageShareOnDistributionPoint <Boolean>]
[-CustomPackageShareName <String>]
[-DeployFromPxeDistributionPoint <Boolean>]
[-Description <String>]
[-DisconnectUserFromDistributionPoint <Boolean>]
[-DisconnectUserFromDistributionPointMins <UInt32>]
[-DisconnectUserFromDistributionPointRetryCount <UInt32>]
[-DistributionPointUpdateSchedule <IResultObject>]
[-EnableBinaryDeltaReplication <Boolean>]
[-EnableCommandSupport <Boolean>]
[-EnablePrestartCommand <Boolean>]
[-Force]
[-IncludeFilesForPrestart <Boolean>]
[-InputLocale <String>]
-InputObject <IResultObject>
[-NewName <String>]
[-PassThru]
[-Path <String>]
[-PersistContentInCache <Boolean>]
[-PrestageBehavior <PrestageBehavior>]
[-PrestartCommandLine <String>]
[-PrestartIncludeFilesDirectory <String>]
[-Priority <Priority>]
[-Reload]
[-RemoveOptionalComponent <IResultObject[]>]
[-ScratchSpace <UInt32>]
[-SendToPreferredDistributionPoint <Boolean>]
[-Version <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Set-CMBootImage
[-AddOptionalComponent <IResultObject[]>]
[-BackgroundBitmapPath <String>]
[-CopyToPackageShareOnDistributionPoint <Boolean>]
[-CustomPackageShareName <String>]
[-DeployFromPxeDistributionPoint <Boolean>]
[-Description <String>]
[-DisconnectUserFromDistributionPoint <Boolean>]
[-DisconnectUserFromDistributionPointMins <UInt32>]
[-DisconnectUserFromDistributionPointRetryCount <UInt32>]
[-DistributionPointUpdateSchedule <IResultObject>]
[-EnableBinaryDeltaReplication <Boolean>]
[-EnableCommandSupport <Boolean>]
[-EnablePrestartCommand <Boolean>]
[-Force]
-Id <String>
[-IncludeFilesForPrestart <Boolean>]
[-InputLocale <String>]
[-NewName <String>]
[-PassThru]
[-Path <String>]
[-PersistContentInCache <Boolean>]
[-PrestageBehavior <PrestageBehavior>]
[-PrestartCommandLine <String>]
[-PrestartIncludeFilesDirectory <String>]
[-Priority <Priority>]
[-Reload]
[-RemoveOptionalComponent <IResultObject[]>]
[-ScratchSpace <UInt32>]
[-SendToPreferredDistributionPoint <Boolean>]
[-Version <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Set-CMBootImage
[-AddOptionalComponent <IResultObject[]>]
[-BackgroundBitmapPath <String>]
[-CopyToPackageShareOnDistributionPoint <Boolean>]
[-CustomPackageShareName <String>]
[-DeployFromPxeDistributionPoint <Boolean>]
[-Description <String>]
[-DisconnectUserFromDistributionPoint <Boolean>]
[-DisconnectUserFromDistributionPointMins <UInt32>]
[-DisconnectUserFromDistributionPointRetryCount <UInt32>]
[-DistributionPointUpdateSchedule <IResultObject>]
[-EnableBinaryDeltaReplication <Boolean>]
[-EnableCommandSupport <Boolean>]
[-EnablePrestartCommand <Boolean>]
[-Force]
[-IncludeFilesForPrestart <Boolean>]
[-InputLocale <String>]
-Name <String>
[-NewName <String>]
[-PassThru]
[-Path <String>]
[-PersistContentInCache <Boolean>]
[-PrestageBehavior <PrestageBehavior>]
[-PrestartCommandLine <String>]
[-PrestartIncludeFilesDirectory <String>]
[-Priority <Priority>]
[-Reload]
[-RemoveOptionalComponent <IResultObject[]>]
[-ScratchSpace <UInt32>]
[-SendToPreferredDistributionPoint <Boolean>]
[-Version <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Descrizione
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.
È possibile aggiungere driver di dispositivo a un'immagine di avvio o modificarne le proprietà. Prima di poter aggiungere un nuovo driver di dispositivo, è necessario importarlo nel catalogo dei driver di Configuration Manager e abilitarlo.
Ogni 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.
Per altre informazioni, vedere Gestire le immagini di avvio con Configuration Manager.
Nota
Eseguire Configuration Manager cmdlet dall'unità del sito Configuration Manager, ad esempio PS XYZ:\>. Per altre informazioni, vedere Introduzione.
Esempio
Esempio 1: Rinominare un'immagine di avvio
Questo comando ottiene un'immagine di avvio in base all'ID pacchetto e quindi la rinomina.
Set-CMBootimage -Id "CM100004" -NewName "Custom boot image"Esempio 2: Impostare proprietà descrittive
Questo comando ottiene un'immagine di avvio in base al nome e quindi aggiunge una versione e una descrizione.
Set-CMBootImage -Name "Custom boot image (x64)" -Version "Contoso v2.1" -Description "Managed by jqpublic"Esempio 3: Impostare il layout della tastiera
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.
Set-CMBootimage -Id "CM100004" -InputLocale "ru-ru"Esempio 4: Aggiungere componenti facoltativi
Questo esempio ottiene i componenti facoltativi di .NET e PowerShell e li aggiunge all'immagine di avvio.
$netfxOC = Get-CMWinPEOptionalComponentInfo -Architecture 'x64' -Name 'WinPE-NetFX' -LanguageId 1033
$pwshOC = Get-CMWinPEOptionalComponentInfo -Architecture 'x64' -Name 'WinPE-PowerShell' -LanguageId 1033
$OCs = @($netfxOC, $pwshOC)
Set-CMBootImage -Id 'XYZ00556' -AddOptionalComponent $OCsParametri
-AddOptionalComponent
Specificare una matrice di oggetti componente facoltativi da aggiungere all'immagine di avvio. Per ottenere questo oggetto, usare il cmdlet Get-CMWinPEOptionalComponentInfo .
I componenti seguenti sono comunemente usati:
- Microsoft .NET (WinPE-NetFX): questo componente è un prerequisito per PowerShell. Si tratta di uno dei componenti facoltativi più grandi.
- Windows PowerShell (WinPE-PowerShell): questo componente richiede .NET e aggiunge un supporto limitato di PowerShell. Se si eseguono script di PowerShell personalizzati durante la fase WinPE della sequenza di attività, aggiungere questo componente. Potrebbero essere necessari altri componenti per altri cmdlet di PowerShell.
- HTML (WinPE-HTA): se si eseguono applicazioni HTML personalizzate durante la fase WinPE della sequenza di attività, aggiungere questo componente.
Per altre informazioni, vedere Gestire le immagini di avvio - Componenti facoltativi.
| Type: | IResultObject[] |
| Aliases: | AddOptionalComponents |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-BackgroundBitmapPath
Specificare il percorso del file di rete di un file di immagine di sfondo personalizzato da usare in Windows PE.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Confirm
Richiede la conferma prima di eseguire il cmdlet.
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-CopyToPackageShareOnDistributionPoint
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.
Quando 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.
| Type: | Boolean |
| Aliases: | CopyToPackageShareOnDistributionPoints |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-CustomPackageShareName
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.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DeployFromPxeDistributionPoint
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.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Description
Specificare una descrizione facoltativa di un'immagine di avvio per identificarla.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DisableWildcardHandling
Questo parametro considera i caratteri jolly come valori letterali. Non è possibile combinarlo con ForceWildcardHandling.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DisconnectUserFromDistributionPoint
Questa opzione è deprecata. Imposta la proprietà ForcedDisconnectEnabled dell'immagine di avvio.
| Type: | Boolean |
| Aliases: | DisconnectUsersFromDistributionPoints |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DisconnectUserFromDistributionPointMins
Questa opzione è deprecata. Imposta la proprietà ForcedDisconnectDelay dell'immagine di avvio.
| Type: | UInt32 |
| Aliases: | DisconnectUsersFromDistributionPointsMinutes |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DisconnectUserFromDistributionPointRetryCount
Questa opzione è deprecata. Imposta la proprietà ForcedDisconnectNumRetries dell'immagine di avvio.
| Type: | UInt32 |
| Aliases: | DisconnectUsersFromDistributionPointsRetries |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DistributionPointUpdateSchedule
Usare questo parametro per aggiornare i punti di distribuzione in base a una pianificazione. Per ottenere un oggetto pianificazione, usare il cmdlet New-CMSchedule .
| Type: | IResultObject |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-EnableBinaryDeltaReplication
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.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-EnableCommandSupport
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.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-EnablePrestartCommand
Impostare questo parametro su $true per abilitare un comando di preavvio. Questa riga di comando viene eseguita prima dell'avvio della sequenza di attività.
Configurare anche i parametri seguenti: IncludeFilesForPrestart, PrestartCommandLine, PrestartIncludeFilesDirectory.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Force
Eseguire il comando senza richiedere conferma.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ForceWildcardHandling
Questo parametro elabora caratteri jolly e può causare un comportamento imprevisto (non consigliato). Non è possibile combinarlo con DisableWildcardHandling.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Id
Specificare un ID immagine di avvio da configurare. Questo valore è un ID pacchetto standard, ad esempio: XYZ00002.
| Type: | String |
| Aliases: | PackageId |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-IncludeFilesForPrestart
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.
Ad esempio, se si vuole eseguire uno script batch, usare questa opzione per includere il file di script.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-InputLocale
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).
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-InputObject
Specificare un oggetto immagine di avvio da configurare. Per ottenere questo oggetto, usare il cmdlet Get-CMBootImage .
| Type: | IResultObject |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Name
Specificare il nome di un'immagine di avvio da configurare.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-NewName
Specificare un nuovo nome per l'immagine di avvio.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PassThru
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.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Path
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.
| Type: | String |
| Aliases: | ImagePath |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PersistContentInCache
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.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PrestageBehavior
Specificare il comportamento quando si abilita un punto di distribuzione per il contenuto pre-installato:
ManualCopy: 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 distribuzione
Per altre informazioni, vedere Usare il contenuto pre-installato.
| Type: | PrestageBehavior |
| Accepted values: | ManualCopy, DownloadDelta, OnDemand |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PrestartCommandLine
Se si abilita EnablePrestartCommand, usare questo parametro per specificare la riga di comando da eseguire. La lunghezza massima è di 4096 caratteri.
Se la riga di comando richiede file non presenti in Windows PE, usare i parametri IncludeFilesForPrestart e PrestartIncludeFilesDirectory .
| Type: | String |
| Aliases: | CommandLine |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PrestartIncludeFilesDirectory
Se abiliti EnablePrestartCommand e IncludeFilesForPrestart, usa questo parametro per specificare il percorso di rete dei file da includere nell'immagine di avvio.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Priority
Specificare l'ordine in cui il sito invia il contenuto ad altri siti e ai punti di distribuzione del sito.
Il 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.
| Type: | Priority |
| Accepted values: | High, Medium, Low |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Reload
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.
| Type: | SwitchParameter |
| Aliases: | ReloadImage |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RemoveOptionalComponent
Specificare una matrice di oggetti componente facoltativi da rimuovere dall'immagine di avvio. Per ottenere questo oggetto, usare il cmdlet Get-CMWinPEOptionalComponentInfo .
Non rimuovere i componenti seguenti, richiesti da Configuration Manager:
- Scripting (WinPE-Scripting)
- Avvio (WinPE-SecureStartup)
- Rete (WinPE-WDS-Tools)
- Scripting (WinPE-WMI)
| Type: | IResultObject[] |
| Aliases: | RemoveOptionalComponents |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ScratchSpace
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.
| Type: | UInt32 |
| Accepted values: | 32, 64, 128, 256, 512 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-SendToPreferredDistributionPoint
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.
| Type: | Boolean |
| Aliases: | SendToPreferredDistributionPoints |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Version
Specificare la versione dell'immagine di avvio. Questo valore non è la versione del sistema operativo, ma una stringa gestita.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-WhatIf
Mostra cosa accade se viene eseguito il cmdlet. Il cmdlet non viene eseguito.
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Input
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
Output
System.Object
Collegamenti correlati
Commenti e suggerimenti
Presto disponibile: Nel corso del 2024 verranno gradualmente disattivati i problemi di GitHub come meccanismo di feedback per il contenuto e ciò verrà sostituito con un nuovo sistema di feedback. Per altre informazioni, vedere https://aka.ms/ContentUserFeedback.
Invia e visualizza il feedback per