Aracılığıyla paylaş

New-CMTSStepApplyOperatingSystem

  • Makale

SYNOPSIS

Bir görev dizisine ek oluşturabilecek bir Işletim Sistemi Görüntüsü Uygula adımı oluşturun.

SYNTAX

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>]

DESCRIPTION

Bu cmdlet yeni bir Işletim Sistemi Görüntüsü Uygula adım nesnesi oluşturur. Ardından Add-CMTaskSequenceStep cmdlet'ini kullanarak adımı bir görev dizisine ekleyin. Bu adım hakkında daha fazla bilgi için bkz. Görev dizisi adımları hakkında: Apply OS Image.

Not

Yapılandırma Yöneticisi site sürücüsünden cmdlet'Yapılandırma Yöneticisi çalıştırın, örneğin PS XYZ:\> . Daha fazla bilgi için başlarken bölümüne bakın.

EXAMPLES

Örnek 1

Bu örnek, işletim sistemi görüntü paketine bir nesnesi almak için önce Get-CMOperatingSystemImage cmdlet'ini kullanır. Bu nesneyi $osImgPkg kaydeder. Sonraki adım, görüntü paketi olarak $osImgPkg nesnesini kullanarak, Işletim Sistemi Görüntüsünü Uygula adımı için bir nesnesi oluşturur.

Ardından bir görev dizisi nesnesi alır ve bu yeni adımı dizin 11'de görev dizisine ekler.

$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

PARAMETERS

-Condition

Bu adımda kullanmak üzere bir koşul nesnesi belirtin. Bu nesneyi almak için görev dizisi koşulu cmdlet'lerinden birini kullanın. Örneğin, Get-CMTSStepConditionVariable.

Type: IResultObject[]
Parameter Sets: (All)
Aliases: Conditions

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

-ConfigFileName

Özel yükleme için kullanmak üzere katılımsız veya Sysprep yanıt dosyası dosya adını belirtin. ConfigFilePackage parametresiyle bu parametreyi kullanın.

Type: String
Parameter Sets: (All)
Aliases: AnswerFileName

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

-ConfigFilePackage

Özel yükleme için kullanmak üzere katılımsız veya Sysprep yanıt dosyası bir paket nesnesi belirtin. Bu nesneyi almak için Get-CMPackage cmdlet'ini kullanın. ConfigFileName parametresiyle bu parametreyi kullanın.

Type: IResultObject
Parameter Sets: (All)
Aliases: AnswerFilePackage

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

-Confirm

Cmdlet'i çalıştırmadan önce sizden onay ister.

Type: SwitchParameter
Parameter Sets: (All)
Aliases: cf

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

-ContinueOnError

Hatada Devam et adım seçeneğini etkinleştirmek için bu parametreyi ekleyin. Bu seçeneği etkinleştirseniz, adım başarısız olursa görev dizisi devam eder.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-Description

Bu görev dizisi adımı için isteğe bağlı bir açıklama belirtin.

Type: String
Parameter Sets: (All)
Aliases:

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

-Destination

Bu işletim sistemi uygulamak istediğiniz konumu belirtin. Bu parametreyi belirtmezseniz varsayılan değer NextAvailableFormattedPartition olur.

  • NextAvailableFormattedPartition: Bu görev dizisinde bir İşletim Sistemi Uygula veya Veri Görüntüsü Uygula adımı tarafından hedeflenmiş bir sonraki sıralı bölümü kullanın.

  • SpecificDiskAndPartition: DestinationDisk parametresiyle disk numarasını ve DestinationPartition parametresiyle bölüm numarasını belirtin.

  • SpecificLogicalDriverLetter: Bölüme atanan mantıksal sürücü harfini PE'ye göre belirtmek için DestinationDriveLetter Windows kullanın. Bu sürücü harfi, yeni dağıtılan işletim sistemi tarafından atanan sürücü harfinden farklı olabilir.

  • LogicalDriverLetterInVariable: Bölüme PE'ye göre atanan sürücü harfini içeren görev dizisi değişkenini belirtmek için DestinationVariable Windows kullanın. Bu değişken genellikle Diski Biçimlendir ve Bölümle görev dizisi adımı için Set-CMTSStepPartitionDisk veya New-CMTSStepPartitionDisk cmdlet'lerinin DiskNumberVariable parametresiyle ayarlanır. 

Type: DestinationType
Parameter Sets: (All)
Aliases:
Accepted values: NextAvailableFormattedPartition, SpecificDiskAndPartition, SpecificLogicalDriverLetter, LogicalDriverLetterInVariable

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

-DestinationDisk

kullanıldığında, -Destination SpecificDiskAndPartition disk numarasını belirtmek için bu parametreyi kullanın. ile bir tamsayı 0 99 belirtin. DestinationPartition parametresini de kullanın.

Type: Int32
Parameter Sets: (All)
Aliases:

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

-DestinationDriveLetter

kullanıldığında, -Destination SpecificLogicalDriverLetter mantıksal sürücü harfini belirtmek için bu parametreyi kullanın. için bir sürücü harfi C Z belirtin.

Type: String
Parameter Sets: (All)
Aliases: DestinationLogicalDrive

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

-DestinationPartition

'i kullanarak -Destination SpecificDiskAndPartition bölüm numarasını belirtmek için bu parametreyi kullanın. ile bir tamsayı 1 99 belirtin. DestinationDisk parametresini de kullanın.

Type: Int32
Parameter Sets: (All)
Aliases:

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

-DestinationVariable

'i -Destination LogicalDriverLetterInVariable kullanırken, görev dizisi değişkenlerini mantıksal sürücü harfiyle belirtmek için bu parametreyi kullanın. Değişken adının boşluk olmadan alfasayısal olması ve 256 karakterden az olması gerekir.

Type: String
Parameter Sets: (All)
Aliases: DestinationVariableName

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

-Disable

Bu görev dizisi adımını devre dışı bırakmak için bu parametreyi ekleyin.

Type: SwitchParameter
Parameter Sets: (All)
Aliases: DisableThisStep

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

-DisableWildcardHandling

Bu parametre joker karakterleri değişmez karakter değerleri olarak kabul eder. Bunu ForceWildcardHandling ile birleştiresiniz.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-ForceWildcardHandling

Bu parametre joker karakterleri işler ve beklenmeyen davranışlara neden olabilir (önerilmez). DisableWildcardHandling ile birleştiresiniz.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-ImagePackage

Bir işletim sistemi görüntü paketi nesnesi belirtin. Bu adım, bu görüntüden işletim sistemi uygular. Görüntü dizinini ayarlamak için ImagePackageIndex parametresini kullanın.

Bu nesneyi almak için Get-CMOperatingSystemImage cmdlet'ini kullanın.

Type: IResultObject
Parameter Sets: (All)
Aliases:

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

-ImagePackageIndex

Görüntü dizininin bir tamsayı değerini belirtin. ImagePackage parametresiyle bu parametreyi kullanın.

Type: Int32
Parameter Sets: (All)
Aliases:

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

-InstallPackage

Bir işletim sistemi yükseltme paketi nesnesi belirtin. Bu adım, bu özgün yükleme kaynağından işletim sistemi uygular. Sürümü ayarlamak için InstallPackageIndex parametresini kullanın.

Bu nesneyi almak için Get-CMOperatingSystemInstaller cmdlet'ini kullanın.

Type: IResultObject
Parameter Sets: (All)
Aliases: UpgradePackage

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

-InstallPackageIndex

Işletim sistemi yükseltme paketi sürümünün tamsayı değerini belirtin. InstallPackage parametresiyle bu parametreyi kullanın.

Type: Int32
Parameter Sets: (All)
Aliases: UpgradePackageIndex

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

-Name

Bu adımı görev dizisinde tanımlamak için bir ad belirtin.

Type: String
Parameter Sets: (All)
Aliases: StepName

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

-RunFromNet

Görev dizisinin $true işletim sistemi görüntüsünü doğrudan dağıtım noktasından uygulamasına izin vermek için bu parametreyi olarak ayarlayın.

En yüksek güvenlik için bu ayarı etkinleştirmeniz önerilmez. Bu seçenek, sınırlı depolama kapasitesine sahip cihazlarda kullanım için tasarlanmıştır. Daha fazla bilgi için bkz. İçeriklere doğrudan dağıtım noktasından erişme.

Type: Boolean
Parameter Sets: (All)
Aliases: AllowAccessFromDistributionPoint

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

-WhatIf

Cmdlet çalıştırılıyorsa ne olacağını gösterir. Cmdlet çalışmaz.

Type: SwitchParameter
Parameter Sets: (All)
Aliases: wi

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

-LayeredDriver

Sürüm 2107'den başlayarak, Japonca ve Korece dillerinde ortak olan diğer klavye türlerini seçmek için bu parametreyi kullanın. Katmanlanan sürücü için bir tamsayı değeri belirtin ve bu değerle Windows. OsdLayeredDriver görev dizisi değişkeniyle aynı değerleri kullanın.

Type: OsdLayeredDriver
Parameter Sets: (All)
Aliases: KeyboardDriver

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

CommonParameters

Bu cmdlet şu genel parametreleri destekler: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction ve -WarningVariable. Daha fazla bilgi için bkz. about_CommonParameters.

INPUTS

Hiçbiri

OUTPUTS

IResultObject#SMS_TaskSequence_ApplyOperatingSystemAction

NOTLAR

Bu dönüş nesnesi ve özellikleri hakkında daha fazla bilgi için bkz. SMS_TaskSequence_ApplyOperatingSystemAction sunucusu WMI sınıfı.

Get-CMTSStepApplyOperatingSystem Remove-CMTSStepApplyOperatingSystem Set-CMTSStepApplyOperatingSystem

Görev dizisi adımları hakkında: Işletim Sistemi Görüntüsünü Uygulama