New-CMPrestageMedia
Creare un file multimediale pre-installato per la distribuzione del sistema operativo.
Sintassi
New-CMPrestageMedia
[-Application <IResultObject[]>]
[-Comment <String>]
[-CreatedBy <String>]
[-DriverPackage <IResultObject[]>]
[-IncludeApplicationDependency]
-OperatingSystemImage <IResultObject>
[-OperatingSystemImageIndex <Int32>]
[-Package <IResultObject[]>]
-TaskSequence <IResultObject>
[-Version <String>]
[-AllowUacPrompt]
[-AllowUnattended]
[-AllowUnknownMachine]
-BootImage <IResultObject>
[-CertificateExpireTime <DateTime>]
[-CertificatePassword <SecureString>]
[-CertificatePath <String>]
[-CertificateStartTime <DateTime>]
-DistributionPoint <IResultObject[]>
[-Force]
-ManagementPoint <IResultObject[]>
[-SiteCode <String>]
-MediaMode <MediaMode>
[-MediaPassword <SecureString>]
[-NoAutoRun]
-Path <String>
[-PrestartCommand <String>]
[-PrestartPackage <IResultObject>]
[-TemporaryFolder <String>]
[-UserDeviceAffinity <UserDeviceAffinityType>]
[-Variable <Hashtable>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Descrizione
Il cmdlet New-CMPrestageMedia crea un file per pre-installare un'immagine del sistema operativo in un nuovo disco rigido. Per altre informazioni, vedere Pianificare i supporti pre-installati.
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 pre-installati
Il primo comando ottiene l'oggetto punto di gestione per il server del sistema del sito denominato mp01.contoso.com nel codice del sito CM1 e archivia l'oggetto nella variabile $ManagementPoint .
Il secondo comando ottiene l'oggetto immagine di avvio denominato BootImage01 e archivia l'oggetto nella variabile $BootImage .
Il terzo comando ottiene l'oggetto punto di distribuzione per il server del sistema del sito denominato dist01.contoso.com nel codice del sito CM1 e archivia l'oggetto nella variabile $DistributionPoint .
Il quarto comando ottiene l'oggetto immagine del sistema operativo denominato OSImagePkg01 e archivia l'oggetto nella variabile $OSImage .
L'ultimo comando crea un file multimediale pre-installato dinamico denominato PrestagedMedia.wim con l'immagine di avvio archiviata in $BootImage, il punto di distribuzione archiviato in $DistributionPoint, il punto di gestione archiviato in $ManagementPoint e l'immagine del sistema operativo archiviata in $OSImage.
$ManagementPoint = Get-CMManagementPoint -SiteSystemServerName "mp01.contoso.com" -SiteCode "CM1"
$BootImage = Get-CMBootImage -Name "BootImage01"
$DistributionPoint = Get-CMDistributionPoint -SiteSystemServerName "dist01.contoso.com" -SiteCode "CM1"
$OSImage = Get-CMOperatingSystemImage -Name "OSImagePkg01"
New-CMPrestageMedia -MediaMode Dynamic -Path "\\server\share\PrestagedMedia.wim" -BootImage $BootImage -DistributionPoint $DistributionPoint -ManagementPoint $ManagementPoint -OperatingSystemImage $OSImage
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 |
-Application
Specificare una matrice di oggetti applicazione da includere come parte del file multimediale. Se la sequenza di attività fa riferimento a questo contenuto, prima cerca il contenuto in locale. Se il contenuto non è presente nel supporto, la sequenza di attività tenta di scaricarlo dalla rete come di consueto. Per ottenere un oggetto applicazione, usare il cmdlet Get-CMApplication .
Tipo: | IResultObject[] |
Alias: | Applications |
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 |
-Comment
Stringa facoltativa per fornire ulteriori dettagli sui supporti. È utile descrivere come è stato configurato o come si userà questo supporto. La lunghezza massima è di 127 caratteri.
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: | None |
Necessario: | False |
Accettare l'input della pipeline: | False |
Accettare caratteri jolly: | False |
-CreatedBy
Stringa facoltativa per specificare chi ha creato questo supporto, utile a scopo di rilevamento. La lunghezza massima è di 50 caratteri.
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 |
-DistributionPoint
Specificare uno o più oggetti punto di distribuzione in cui è stato distribuito il contenuto per questo supporto. 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 |
-DriverPackage
Specificare una matrice di oggetti pacchetto driver da includere come parte del file multimediale. Se la sequenza di attività fa riferimento a questo contenuto, cerca il contenuto in locale. Se il contenuto non è presente nel supporto, la sequenza di attività tenta di scaricarlo dalla rete come di consueto. Per ottenere questo oggetto, usare il cmdlet Get-CMDriverPackage .
Tipo: | IResultObject[] |
Alias: | DriverPackages, PackageDriver, PackageDrivers |
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 |
-IncludeApplicationDependency
Aggiungere questo parametro per rilevare le dipendenze dell'applicazione associate e aggiungerle a questo supporto.
Tipo: | SwitchParameter |
Alias: | IncludeApplicationDependencies |
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 |
-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 |
-OperatingSystemImage
Specificare un oggetto pacchetto immagine del sistema operativo da includere per questo supporto. Usare il parametro OperatingSystemImageIndex per specificare l'indice dell'immagine nel pacchetto dell'immagine. Per ottenere questo oggetto, usare il cmdlet Get-CMOperatingSystemImage .
Tipo: | IResultObject |
Alias: | OperatingSystemImagePackage |
Posizione: | Named |
Valore predefinito: | None |
Necessario: | True |
Accettare l'input della pipeline: | False |
Accettare caratteri jolly: | False |
-OperatingSystemImageIndex
Specificare l'indice dell'immagine nel pacchetto dell'immagine dal parametro OperatingSystemImage .
Tipo: | Int32 |
Posizione: | Named |
Valore predefinito: | None |
Necessario: | False |
Accettare l'input della pipeline: | False |
Accettare caratteri jolly: | False |
-Package
Specificare una matrice di oggetti pacchetto da includere nel file multimediale. Se la sequenza di attività fa riferimento a questo contenuto, cerca il contenuto in locale. Se il contenuto non è presente nel supporto, la sequenza di attività tenta di scaricarlo dalla rete come di consueto. Per ottenere questo oggetto, usare il cmdlet Get-CMPackage .
Tipo: | IResultObject[] |
Alias: | Packages |
Posizione: | Named |
Valore predefinito: | None |
Necessario: | False |
Accettare l'input della pipeline: | False |
Accettare caratteri jolly: | False |
-Path
Percorso del file multimediale da creare. Il formato è un percorso unità/directory o un percorso di rete valido. Ad esempio:
C:\media\prestaged1.wim
\\server\share\prestaged1.wim
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 una riga di comando da eseguire prima dell'avvio della sequenza di attività. Per altre informazioni, vedere Comandi di preavvio per i supporti della sequenza di attività.
Tipo: | String |
Alias: | PreExecCommandLine |
Posizione: | Named |
Valore predefinito: | None |
Necessario: | False |
Accettare l'input della pipeline: | False |
Accettare caratteri jolly: | False |
-PrestartPackage
Se si specifica un prestartCommand, usare questo parametro per specificare un pacchetto per il contenuto di preavvio, se necessario.
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 |
-TaskSequence
Specificare un oggetto sequenza di attività per l'esecuzione di questo supporto. Per ottenere questo oggetto, usare il cmdlet Get-CMTaskSequence .
Tipo: | IResultObject |
Posizione: | Named |
Valore predefinito: | None |
Necessario: | True |
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 tabella hash delle variabili della sequenza di attività da usare durante la distribuzione della sequenza di attività da questo supporto.
Tipo: | Hashtable |
Alias: | TaskSequenceVariables, Variables |
Posizione: | Named |
Valore predefinito: | None |
Necessario: | False |
Accettare l'input della pipeline: | False |
Accettare caratteri jolly: | False |
-Version
Valore stringa facoltativo per specificare una versione per questo supporto, utile a scopo di rilevamento e revisione. La lunghezza massima è di 32 caratteri.
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: | None |
Necessario: | False |
Accettare l'input della pipeline: | False |
Accettare caratteri jolly: | False |
Input
None
Output
System.Object
Note
Alias dei cmdlet: New-CMPrestagedMedia