New-CMTSStepApplyOperatingSystem
Crea un passaggio Applica immagine del sistema operativo, che puoi aggiungere a una sequenza di attività.
Sintassi
New-CMTSStepApplyOperatingSystem
[-ConfigFileName <String>]
[-ConfigFilePackage <IResultObject>]
[-Destination <DestinationType>]
[-DestinationDisk <Int32>]
[-DestinationDriveLetter <String>]
[-LayeredDriver <OsdLayeredDriver>]
[-DestinationPartition <Int32>]
[-DestinationVariable <String>]
[-ImagePackage <IResultObject>]
[-ImagePackageIndex <Int32>]
[-InstallPackage <IResultObject>]
[-InstallPackageIndex <Int32>]
[-RunFromNet <Boolean>]
[-Condition <IResultObject[]>]
[-ContinueOnError]
[-Description <String>]
[-Disable]
-Name <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Descrizione
Questo cmdlet crea un nuovo oggetto passaggio Applica immagine del sistema operativo. Utilizzare quindi il cmdlet Add-CMTaskSequenceStep per aggiungere il passaggio a una sequenza di attività. Per ulteriori informazioni su questo passaggio, vedere About task sequence steps: Apply OS Image.
Nota
Eseguire i cmdlet di Configuration Manager dall'unità del sito di Configuration Manager, ad esempio PS XYZ:\>
. Per ulteriori informazioni, vedere Introduzione.
Esempio
Esempio 1
In questo esempio viene innanzitutto utilizzato il cmdlet Get-CMOperatingSystemImage per ottenere un oggetto per il pacchetto di immagini del sistema operativo. Salva l'oggetto nella variabile $osImgPkg variabile. Il passaggio successivo crea un oggetto per il passaggio Applica immagine del sistema operativo, usando l'$osImgPkg come pacchetto di immagini.
Ottiene quindi un oggetto della sequenza di attività e aggiunge questo nuovo passaggio alla sequenza di attività in corrispondenza dell'indice 11.
$osImgPkg = Get-CMOperatingSystemImage -Name "OSImagePkg01"
$step = New-CMTSStepApplyOperatingSystem -Name "Apply OS image" -ImagePackage $osImgPkg -ImagePackageIndex 1
$tsNameOsd = "Default OS deployment"
$tsOsd = Get-CMTaskSequence -Name $tsNameOsd -Fast
$tsOsd | Add-CMTaskSequenceStep -Step $step -InsertStepStartIndex 11
Parametri
-Condition
Specificare un oggetto condizione da utilizzare con questo passaggio. Per ottenere questo oggetto, utilizzare uno dei cmdlet delle condizioni della sequenza di attività. Ad esempio, Get-CMTSStepConditionVariable.
Type: | IResultObject[] |
Aliases: | Conditions |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ConfigFileName
Specificare il nome file di un file di risposta automatico o Sysprep da utilizzare per un'installazione personalizzata. Utilizzare questo parametro con il parametro ConfigFilePackage.
Type: | String |
Aliases: | AnswerFileName |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ConfigFilePackage
Specificare un oggetto pacchetto che includa il file di risposta automatico o Sysprep da utilizzare per un'installazione personalizzata. Per ottenere questo oggetto, utilizzare il cmdlet Get-CMPackage. Utilizzare questo parametro con il parametro ConfigFileName.
Type: | IResultObject |
Aliases: | AnswerFilePackage |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Confirm
Richiede la conferma prima di eseguire il cmdlet.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ContinueOnError
Aggiungere questo parametro per abilitare l'opzione del passaggio Continua in caso di errore. Quando abiliti questa opzione, se il passaggio ha esito negativo, la sequenza di attività continua.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Description
Specificare una descrizione facoltativa per questo passaggio della sequenza di attività.
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Destination
Specificare il percorso in cui si desidera applicare il sistema operativo. Se non si specifica questo parametro, il valore predefinito è NextAvailableFormattedPartition
.
NextAvailableFormattedPartition
: usa la partizione sequenziale successiva non già destinata **** a un passaggio Applica sistema operativo o Applica immagine dati in questa sequenza di attività.SpecificDiskAndPartition
: specificare il numero di disco con il parametro DestinationDisk e il numero di partizione con il parametro DestinationPartition.SpecificLogicalDriverLetter
: utilizzare il parametro DestinationDriveLetter per specificare la lettera di unità logica assegnata alla partizione Windows PE. Questa lettera di unità può essere diversa dalla lettera di unità assegnata dal sistema operativo appena distribuito.LogicalDriverLetterInVariable
: utilizzare il parametro DestinationVariable per specificare la variabile della sequenza di attività contenente la lettera di unità assegnata alla partizione Windows PE. Questa variabile viene in genere impostata con il parametro DiskNumberVariable dei cmdlet Set-CMTSStepPartitionDisk o New-CMTSStepPartitionDisk per il passaggio della sequenza di attività Format e Partition Disk.
Type: | DestinationType |
Accepted values: | NextAvailableFormattedPartition, SpecificDiskAndPartition, SpecificLogicalDriverLetter, LogicalDriverLetterInVariable |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DestinationDisk
Quando si utilizza -Destination SpecificDiskAndPartition
, utilizzare questo parametro per specificare il numero di disco. Specificare un numero intero da 0
a 99
. Utilizzare anche il parametro DestinationPartition.
Type: | Int32 |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DestinationDriveLetter
Quando si utilizza -Destination SpecificLogicalDriverLetter
, utilizzare questo parametro per specificare la lettera di unità logica. Specificare una lettera di unità da C
a Z
.
Type: | String |
Aliases: | DestinationLogicalDrive |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DestinationPartition
Quando si utilizza -Destination SpecificDiskAndPartition
, utilizzare questo parametro per specificare il numero di partizione. Specificare un numero intero da 1
a 99
. Utilizzare anche il parametro DestinationDisk.
Type: | Int32 |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DestinationVariable
Quando si utilizza , utilizzare questo parametro per specificare la variabile della sequenza di -Destination LogicalDriverLetterInVariable
attività con la lettera di unità logica. Il nome della variabile deve essere alfanumerico senza spazi e meno di 256 caratteri.
Type: | String |
Aliases: | DestinationVariableName |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Disable
Aggiungi questo parametro per disabilitare questo passaggio della sequenza di attività.
Type: | SwitchParameter |
Aliases: | DisableThisStep |
Position: | Named |
Default value: | None |
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 |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ForceWildcardHandling
Questo parametro elabora i caratteri jolly e può causare un comportamento imprevisto (scelta non consigliata). Non è possibile combinarlo con DisableWildcardHandling.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ImagePackage
Specifica un oggetto pacchetto di immagini del sistema operativo. Il passaggio applica il sistema operativo da questa immagine. Usa il parametro ImagePackageIndex per impostare l'indice dell'immagine.
Per ottenere questo oggetto, utilizzare il cmdlet Get-CMOperatingSystemImage.
Type: | IResultObject |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ImagePackageIndex
Specificare un valore intero dell'indice dell'immagine. Usa questo parametro con il parametro ImagePackage.
Type: | Int32 |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InstallPackage
Specificare un oggetto pacchetto di aggiornamento del sistema operativo. Il passaggio applica il sistema operativo da questa origine di installazione originale. Usa il parametro InstallPackageIndex per impostare l'edizione.
Per ottenere questo oggetto, utilizzare il cmdlet Get-CMOperatingSystemInstaller.
Type: | IResultObject |
Aliases: | UpgradePackage |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InstallPackageIndex
Specificare un valore intero dell'edizione del pacchetto di aggiornamento del sistema operativo. Usa questo parametro con il parametro InstallPackage.
Type: | Int32 |
Aliases: | UpgradePackageIndex |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-LayeredDriver
A partire dalla versione 2107, utilizzare questo parametro per selezionare altri tipi di tastiere comuni alle lingue giapponesi e coreane. Specificare un valore intero per il driver a più livelli da installare con Windows. Usa gli stessi valori della variabile della sequenza di attività OsdLayeredDriver.
Type: | OsdLayeredDriver |
Aliases: | KeyboardDriver |
Accepted values: | DoNotSpecify, Driver1, Driver2, Driver3, Driver4, Driver5, Driver6 |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Name
Specificare un nome per questo passaggio per identificarlo nella sequenza di attività.
Type: | String |
Aliases: | StepName |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RunFromNet
Impostare questo parametro su $true
per consentire alla sequenza di attività di applicare l'immagine del sistema operativo direttamente dal punto di distribuzione.
Per una maggiore sicurezza, è consigliabile non abilitare questa impostazione. Questa opzione è progettata per l'uso in dispositivi con capacità di archiviazione limitata. Per ulteriori informazioni, vedere Accedere al contenuto direttamente dal punto di distribuzione.
Type: | Boolean |
Aliases: | AllowAccessFromDistributionPoint |
Position: | Named |
Default value: | None |
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: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Input
Nessuno
Output
IResultObject
Note
Per ulteriori informazioni su questo oggetto restituito e sulle relative proprietà, vedere SMS_TaskSequence_ApplyOperatingSystemAction WMI server.