Condividi tramite

New-CMBootableMedia

  • Riferimento
Modulo:
ConfigurationManager

Creare supporti di avvio.

Sintassi

New-CMBootableMedia
   [-AllowUacPrompt]
   [-AllowUnattended]
   [-AllowUnknownMachine]
   -BootImage <IResultObject>
   [-CertificateExpireTime <DateTime>]
   [-CertificatePassword <SecureString>]
   [-CertificatePath <String>]
   [-CertificateStartTime <DateTime>]
   -DistributionPoint <IResultObject[]>
   [-Force]
   [-FormatMedia]
   -ManagementPoint <IResultObject[]>
   [-SiteCode <String>]
   -MediaMode <MediaMode>
   [-MediaPassword <SecureString>]
   -MediaType <MediaInputType>
   [-NoAutoRun]
   -Path <String>
   [-PrestartCommand <String>]
   [-PrestartPackage <IResultObject>]
   [-TemporaryFolder <String>]
   [-UserDeviceAffinity <UserDeviceAffinityType>]
   [-Variable <Hashtable>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Descrizione

Questo cmdlet crea i supporti usati per distribuire un sistema operativo. Il supporto di avvio contiene l'immagine di avvio, i comandi di preavvio facoltativi e i file associati e i file di Configuration Manager. Usare il supporto di avvio per installare una nuova versione di Windows in un nuovo computer (bare metal) o per sostituire un computer esistente e trasferire le impostazioni.

Nota

Questo cmdlet richiede autorizzazioni elevate per l'esecuzione.

Per altre informazioni, vedere Panoramica dei supporti della sequenza di attività.

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: Creare supporti di avvio

Il primo comando ottiene l'oggetto immagine di avvio denominato Boot image (x64) e lo archivia nella variabile $BootImage . Il secondo comando ottiene il ruolo del punto di distribuzione per SiteServer01.Contoso.com e lo archivia nella variabile $DistributionPoint . Il terzo comando ottiene il ruolo del punto di gestione per SiteServer02.Contoso.com e lo archivia nella variabile $ManagementPoint . L'ultimo comando crea supporti di avvio in modalità dinamica. Usa gli oggetti archiviati nelle variabili precedenti.

$BootImage = Get-CMBootImage -Name "Boot image (x64)"
$DistributionPoint = Get-CMDistributionPoint -SiteCode CM1
$ManagementPoint = Get-CMManagementPoint -SiteSystemServerName "SiteSystemServer02.Contoso.com"

New-CMBootableMedia -MediaMode Dynamic -MediaType CdDvd -Path "\\Server\share\test.iso" -AllowUnknownMachine -BootImage $BootImage -DistributionPoint $DistributionPoint -ManagementPoint $ManagementPoint

Parametri

-AllowUacPrompt

Aggiungere questo parametro per consentire a Windows di richiedere di elevare le autorizzazioni di amministratore con Controllo dell'account utente. Questo cmdlet richiede autorizzazioni elevate per l'esecuzione.

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

-AllowUnattended

Aggiungere questo parametro per consentire una distribuzione automatica del sistema operativo. Una distribuzione automatica del sistema operativo non richiede la configurazione di rete o sequenze di attività facoltative.

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

-AllowUnknownMachine

Aggiungere questo parametro per consentire a Configuration Manager di effettuare il provisioning di computer sconosciuti. Un computer sconosciuto è un computer che il sito non ha ancora individuato.

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

-BootImage

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

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

-CertificateExpireTime

Se si crea un certificato multimediale autofirma per la comunicazione HTTP, questo parametro specifica la data e l'ora di scadenza del certificato. Specificare un valore datetime sufficientemente in futuro. Alla scadenza di questo certificato, non è possibile usare il supporto di avvio. Usare il parametro -CertificateStartTime per impostare la data di inizio.

Ad esempio:

$date = [datetime]::p arseexact("11/16/2021", 'MM/dd/yyyy', $null)

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

-CertificatePassword

Se si usa il parametro -CertificatePath per importare un certificato PKI per la comunicazione HTTPS, usare questo parametro per specificare la password per il file di certificato.

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

-CertificatePath

Specificare il percorso di un certificato PKI da importare. Usare il parametro -CertificatePassword per specificare la password per questo file di certificato. Usare questi parametri se si configura il sito per la comunicazione client HTTPS.

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

-CertificateStartTime

Per creare un certificato autofirma per la comunicazione HTTP, questo parametro specifica la data e l'ora di inizio del certificato. Usare il parametro -CertificateExpireTime per impostare la data di scadenza. Non è possibile usare il supporto di avvio fino a questa data.

Ad esempio:

$date = [datetime]::p arseexact("11/16/2020", 'MM/dd/yyyy', $null)

Tipo:DateTime
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

-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

-DistributionPoint

Specificare uno o più oggetti punto di distribuzione in cui è stata distribuita l'immagine di avvio. Per ottenere questo oggetto, usare il cmdlet Get-CMDistributionPoint .

Tipo:IResultObject[]
Alias:DistributionPoints
Posizione:Named
Valore predefinito:None
Necessario:True
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

-FormatMedia

Se MediaType è , è Usbpossibile aggiungere questo parametro per formattare l'unità USB rimovibile come FAT32 e renderla avviabile.

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

-ManagementPoint

Specificare uno o più oggetti punto di gestione usati dal supporto nella comunicazione iniziale. Usare il parametro -MediaMode per determinare il modo in cui il supporto comunica quando viene eseguito. Per ottenere questo oggetto, usare il cmdlet Get-CMManagementPoint .

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

-MediaMode

Specificare il modo in cui il client trova un punto di gestione per ottenere informazioni sulla distribuzione:

  • Dynamic: il supporto contatta un punto di gestione, che reindirizza il client a un punto di gestione diverso in base alla posizione del client nei limiti del sito.

  • SiteBased: il supporto comunica il punto di gestione specificato con il parametro -ManagementPoint .

Tipo:MediaMode
Valori accettati:Dynamic, SiteBased
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-MediaPassword

Specificare una password di stringa sicura per proteggere il supporto della sequenza di attività. Quando si avvia un dispositivo con questo supporto, è necessario immettere la password per continuare.

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

-MediaType

Specificare se il supporto è un set di CD/DVD o un'unità USB rimovibile.

Tipo:MediaInputType
Valori accettati:Usb, CdDvd
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-NoAutoRun

Aggiungere questo parametro per includere il file autorun.inf nel supporto. Configuration Manager non lo aggiunge per impostazione predefinita. Questo file è comunemente bloccato dai prodotti antimalware. Per altre informazioni sulla funzionalità Di esecuzione automatica di Windows, vedere Creazione di un'applicazione CD-ROM abilitata per l'esecuzione automatica. Se ancora necessario per lo scenario, aggiungere questo parametro per includere il file.

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

-Path

Se MediaType è CdDvd, specificare il nome e il percorso in cui Configuration Manager scrive i file di output. Ad esempio, C:\output\boot.iso.

Tipo:String
Alias:MediaPath, OutputPath, DriveName
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-PrestartCommand

Specificare un comando di preavvio eseguito prima della sequenza di attività. Un comando di preavvio è uno script o un eseguibile che può interagire con l'utente in Windows PE prima dell'esecuzione della sequenza di attività per installare il sistema operativo. Se il comando non è nativo di Windows PE, usare PrestartPackage per includere i file per il comando.

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

-PrestartPackage

Se si usa il parametro PrestartCommand , usare questo parametro per specificare un pacchetto contenente i file per il comando di preavvio. Per ottenere l'oggetto pacchetto, usare il cmdlet Get-CMPackage .

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

-SiteCode

Si applica alla versione 2010 e successive. Usare questo parametro con il parametro ManagementPoint per specificare il codice del sito.

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

-TemporaryFolder

Il processo di creazione dei supporti può richiedere molto spazio temporaneo sull'unità. Per impostazione predefinita, Configuration Manager usa la directory temporanea dell'utente corrente: $env:temp. Ad esempio, C:\Users\jqpublic\AppData\Local\Temp\. Per offrire una maggiore flessibilità con la posizione in cui archiviare questi file temporanei, specificare un percorso personalizzato per la gestione temporanea dei dati temporanei.

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

-UserDeviceAffinity

Per supportare la gestione incentrata sull'utente in Configuration Manager, specificare come si vuole che il supporto associ gli utenti al computer di destinazione. Per altre informazioni sul modo in cui la distribuzione del sistema operativo supporta l'affinità utente-dispositivo, vedere Associare gli utenti a un computer di destinazione.

  • DoNotAllow: non consentire l'affinità utente-dispositivo. Il supporto non associa gli utenti al computer di destinazione. In questo scenario, la sequenza di attività non associa gli utenti al computer di destinazione quando distribuisce il sistema operativo.

  • AdministratorApproval: consente l'affinità utente-dispositivo in attesa dell'approvazione dell'amministratore. Il supporto associa gli utenti al computer di destinazione dopo aver concesso l'approvazione. Questa funzionalità si basa sull'ambito della sequenza di attività che distribuisce il sistema operativo. In questo scenario, la sequenza di attività crea una relazione tra gli utenti specificati e il computer di destinazione. Attende quindi l'approvazione da parte di un utente amministratore prima di distribuire il sistema operativo.

  • AutoApproval: consente l'affinità utente-dispositivo con l'approvazione automatica. Il supporto associa automaticamente gli utenti al computer di destinazione. Questa funzionalità si basa sulle azioni della sequenza di attività che distribuisce il sistema operativo. In questo scenario, la sequenza di attività crea una relazione tra gli utenti specificati e il computer di destinazione quando distribuisce il sistema operativo nel computer di destinazione.

Tipo:UserDeviceAffinityType
Valori accettati:DoNotAllow, AdministratorApproval, AutoApproval
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Variable

Specificare una o più variabili e valori della sequenza di attività in una tabella hash. Una variabile della sequenza di attività è una coppia nome/valore usata durante la distribuzione della sequenza di attività.

Tipo:Hashtable
Alias:TaskSequenceVariables, Variables
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

None

Output

System.Object