Set-CMBootImage

Riferimento

Modulo:: ConfigurationManager

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 aggiungere un nuovo driver di dispositivo, è necessario importare il driver 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 i cmdlet di Configuration Manager dall'unità del sito di 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 $OCs

Parametri

-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.

Tipo:	IResultObject[]
Alias:	AddOptionalComponents
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-BackgroundBitmapPath

Specificare il percorso del file di rete di un file di immagine di sfondo personalizzato da usare in Windows PE.

Tipo:	String
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-Confirm

Richiede la conferma prima di eseguire il cmdlet.

Tipo:	SwitchParameter
Alias:	cf
Posizione:	Named
Valore predefinito:	False
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	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.

Tipo:	Boolean
Alias:	CopyToPackageShareOnDistributionPoints
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	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.

Tipo:	String
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	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.

Tipo:	Boolean
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-Description

Specificare una descrizione facoltativa di un'immagine di avvio per identificarla.

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

-DisconnectUserFromDistributionPoint

Questa opzione è deprecata. Imposta la proprietà ForcedDisconnectEnabled dell'immagine di avvio.

Tipo:	Boolean
Alias:	DisconnectUsersFromDistributionPoints
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-DisconnectUserFromDistributionPointMins

Questa opzione è deprecata. Imposta la proprietà ForcedDisconnectDelay dell'immagine di avvio.

Tipo:	UInt32
Alias:	DisconnectUsersFromDistributionPointsMinutes
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-DisconnectUserFromDistributionPointRetryCount

Questa opzione è deprecata. Imposta la proprietà ForcedDisconnectNumRetries dell'immagine di avvio.

Tipo:	UInt32
Alias:	DisconnectUsersFromDistributionPointsRetries
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	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 .

Tipo:	IResultObject
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	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.

Tipo:	Boolean
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	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.

Tipo:	Boolean
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	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.

Tipo:	Boolean
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-Force

Eseguire il comando senza richiedere conferma.

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

-Id

Specificare un ID immagine di avvio da configurare. Questo valore è un ID pacchetto standard, ad esempio: XYZ00002.

Tipo:	String
Alias:	PackageId
Posizione:	Named
Valore predefinito:	None
Necessario:	True
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	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.

Tipo:	Boolean
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	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).

Tipo:	String
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-InputObject

Specificare un oggetto immagine di avvio da configurare. Per ottenere questo oggetto, usare il cmdlet Get-CMBootImage .

Tipo:	IResultObject
Posizione:	Named
Valore predefinito:	None
Necessario:	True
Accettare l'input della pipeline:	True
Accettare caratteri jolly:	False

-Name

Specificare il nome di un'immagine di avvio da configurare.

Tipo:	String
Posizione:	Named
Valore predefinito:	None
Necessario:	True
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-NewName

Specificare un nuovo nome per l'immagine di avvio.

Tipo:	String
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	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.

Tipo:	SwitchParameter
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	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.

Tipo:	String
Alias:	ImagePath
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	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.

Tipo:	Boolean
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	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 distribuzione
DownloadDelta: scaricare solo le modifiche al contenuto nel punto di distribuzione
OnDemand: scaricare automaticamente il contenuto quando i pacchetti vengono assegnati ai punti di distribuzione

Per altre informazioni, vedere Usare il contenuto pre-installato.

Tipo:	PrestageBehavior
Valori accettati:	ManualCopy, DownloadDelta, OnDemand
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	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 .

Tipo:	String
Alias:	CommandLine
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-PrestartIncludeFilesDirectory

Se abiliti EnablePrestartCommand e IncludeFilesForPrestart, usa questo parametro per specificare il percorso di rete dei file da includere nell'immagine di avvio.

Tipo:	String
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	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.

Tipo:	Priority
Valori accettati:	High, Medium, Low
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	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.

Tipo:	SwitchParameter
Alias:	ReloadImage
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	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)

Tipo:	IResultObject[]
Alias:	RemoveOptionalComponents
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	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.

Tipo:	UInt32
Valori accettati:	32, 64, 128, 256, 512
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	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.

Tipo:	Boolean
Alias:	SendToPreferredDistributionPoints
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-Version

Specificare la versione dell'immagine di avvio. Questo valore non è la versione del sistema operativo, ma una stringa gestita.

Tipo:	String
Posizione:	Named
Valore predefinito:	None
Necessario:	False
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:	False
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

Input

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Output

System.Object

Condividi tramite