New-CMOperatingSystemImage

Creare un'immagine del sistema operativo.

Sintassi

New-CMOperatingSystemImage
   [-Description <String>]
   -Name <String>
   -Path <String>
   [-Index <Int32>]
   [-Version <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Descrizione

Usare questo cmdlet per aggiungere un'immagine del sistema operativo a un sito di Configuration Manager. Le immagini del sistema operativo sono file WIM che rappresentano una raccolta compressa di file e cartelle di riferimento. Configuration Manager usa queste immagini con una sequenza di attività per distribuire un sistema operativo in un computer. Per altre informazioni, vedere Gestire le immagini del sistema operativo 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: Creare un'immagine del sistema operativo

Questo comando crea l'immagine del sistema operativo denominata "Windows 10 latest" dal percorso di rete ai file di origine dell'installazione dell'immagine del sistema operativo.

New-CMOperatingSystemImage -Name "Windows 10 latest" -Path "\\Contoso01\CM\Images\win10_latest.wim"

Parametri

-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

-Description

Specificare una descrizione facoltativa per identificare l'immagine. 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

-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

-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

-Index

Quando si aggiunge questo parametro, il sito estrae una singola immagine di indice da un'immagine a più indici. Inserisce quindi la nuova immagine nella stessa cartella di origine dell'immagine originale.

L'uso di questa opzione comporta un file di immagine più piccolo e una manutenzione offline più veloce. Supporta anche il processo per ottimizzare la manutenzione delle immagini, per un file di immagine più piccolo dopo l'applicazione degli aggiornamenti software.

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

-Name

Specificare il nome dell'immagine del sistema operativo. La lunghezza massima è di 50 caratteri.

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

-Path

Specificare il percorso di rete del file WIM dell'immagine del sistema operativo. Il percorso deve includere il nome del file WIM con l'estensione .wim .

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

-Version

Specificare una versione facoltativa dell'immagine del sistema operativo. Questo valore è destinato al controllo delle versioni interno, non alla versione del sistema operativo. 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:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

Input

None

Output

IResultObject

Note

Per altre informazioni su questo oggetto restituito e sulle relative proprietà, vedere SMS_ImagePackage classe WMI del server.