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 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 Configuration Manager cmdlet dall'unità del sito 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.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Description

Specificare una descrizione facoltativa per identificare l'immagine. La lunghezza massima è di 127 caratteri.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DisableWildcardHandling

Questo parametro considera i caratteri jolly come valori letterali. Non è possibile combinarlo con ForceWildcardHandling.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ForceWildcardHandling

Questo parametro elabora caratteri jolly e può causare un comportamento imprevisto (non consigliato). Non è possibile combinarlo con DisableWildcardHandling.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:Int32
Aliases:ImageIndex
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

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

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters: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 .

Type:String
Aliases:PackageSourcePath
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters: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.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Mostra cosa accade se viene eseguito il cmdlet. Il cmdlet non viene eseguito.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Input

None

Output

IResultObject

Note

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