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.