Sdílet prostřednictvím

New-CMTSStepApplyOperatingSystem

  • Článek

SYNOPSIS

Vytvořte krok Použít image operačního systému, který můžete přidat do pořadí úkolů.

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

Tato rutina vytvoří nový objekt kroku Použít image operačního systému. Potom pomocí rutiny Add-CMTaskSequenceStep přidejte krok do pořadí úkolů. Další informace o tomto kroku najdete v tématu Informace o krocích pořadí úkolů: Použití image operačního systému.

Poznámka

Spusťte Správce konfigurace rutiny z Správce konfigurace lokality, například PS XYZ:\> . Další informace najdete v tématu Začínáme.

EXAMPLES

Příklad 1

Tento příklad nejprve používá rutinu Get-CMOperatingSystemImage k získání objektu pro balíček image operačního systému. Tento objekt se uloží do $osImgPkg proměnné. Další krok vytvoří objekt pro krok Apply OS Image (Použít image operačního systému) pomocí $osImgPkg jako balíčku image.

Potom získá objekt pořadí úkolů a přidá tento nový krok do pořadí úkolů na indexu 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

PARAMETERS

-Condition (Podmínka)

Zadejte objekt podmínky, který se má v tomto kroku použít. Chcete-li získat tento objekt, použijte jednu z rutin podmínek pořadí úkolů. Například 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

Zadejte název souboru bezobslužné instalace nebo souboru odpovědí Sysprep, který se má použít pro vlastní instalaci. Tento parametr použijte s parametrem ConfigFilePackage.

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

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

-ConfigFilePackage

Určete objekt balíčku, který obsahuje bezobslužný soubor odpovědí nebo soubor odpovědí Sysprep, který se má použít pro vlastní instalaci. K získání tohoto objektu použijte rutinu Get-CMPackage. Tento parametr použijte s parametrem ConfigFileName.

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

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

-Confirm

Před spuštěním rutiny zobrazí výzvu k potvrzení.

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

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

-ContinueOnError

Přidáním tohoto parametru povolte možnost kroku Pokračovat při chybě. Pokud tuto možnost povolíte, pořadí úkolů bude pokračovat, pokud krok selže.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-Description (Popis)

Zadejte volitelný popis pro tento krok pořadí úkolů.

Type: String
Parameter Sets: (All)
Aliases:

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

-Destination (Cíl)

Zadejte umístění, kde chcete tento operační systém použít. Pokud tento parametr nezadáte, výchozí hodnota je NextAvailableFormattedPartition .

  • NextAvailableFormattedPartition: V tomto pořadí úkolů použijte další sekvenční oddíl, který ještě není cílem kroku Použít operační systém nebo Použít bitovou kopii dat.

  • SpecificDiskAndPartition: Zadejte číslo disku pomocí parametru DestinationDisk a čísla oddílu pomocí parametru DestinationPartition.

  • SpecificLogicalDriverLetter: Pomocí parametru DestinationDriveLetter určete písmeno logické jednotky přiřazené oddílu Windows PE. Toto písmeno jednotky se může lišit od písmene jednotky přiřazeného nově nasazeným operačním systémem.

  • LogicalDriverLetterInVariable: Pomocí parametru DestinationVariable určete proměnnou pořadí úkolů obsahující písmeno jednotky přiřazené k oddílu Windows PE. Tato proměnná se obvykle nastavuje pomocí parametru DiskNumberVariable rutiny Set-CMTSStepPartitionDisk nebo New-CMTSStepPartitionDisk pro krok pořadí úkolů Formátovat a rozdělit disk na oddíly.

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

Pokud použijete -Destination SpecificDiskAndPartition , použijte tento parametr k určení čísla disku. Zadejte celé číslo od 0 do 99 . Použijte také parametr DestinationPartition.

Type: Int32
Parameter Sets: (All)
Aliases:

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

-DestinationDriveLetter

Pokud použijete -Destination SpecificLogicalDriverLetter , použijte tento parametr k určení písmena logické jednotky. Zadejte písmeno jednotky od C do Z .

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

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

-DestinationPartition

Pokud použijete -Destination SpecificDiskAndPartition , použijte tento parametr k určení čísla oddílu. Zadejte celé číslo od 1 do 99 . Použijte také parametr DestinationDisk.

Type: Int32
Parameter Sets: (All)
Aliases:

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

-DestinationVariable

Pokud použijete -Destination LogicalDriverLetterInVariable , použijte tento parametr k určení proměnné pořadí úkolů s písmenem logické jednotky. Název proměnné musí být alfanumerický bez mezer a musí mít méně než 256 znaků.

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

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

-Disable (Zakázat)

Přidáním tohoto parametru tento krok pořadí úkolů zakážete.

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

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

-DisableWildcardHandling

Tento parametr považuje zástupné znaky za hodnoty literálových znaků. Nemůžete ho kombinovat s forceWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-ForceWildcardHandling

Tento parametr zpracovává zástupné znaky a může vést k neočekávanému chování (nedoporučuje se). Nemůžete ho kombinovat s příkazem DisableWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-ImagePackage

Zadejte objekt balíčku image operačního systému. Tento krok použije operační systém z této image. K nastavení indexu obrázku použijte parametr ImagePackageIndex.

K získání tohoto objektu použijte rutinu Get-CMOperatingSystemImage.

Type: IResultObject
Parameter Sets: (All)
Aliases:

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

-ImagePackageIndex

Zadejte celočíselnou hodnotu indexu obrázku. Tento parametr použijte s parametrem ImagePackage.

Type: Int32
Parameter Sets: (All)
Aliases:

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

-InstallPackage

Zadejte objekt balíčku s upgradem operačního systému. Tento krok použije operační systém z tohoto původního zdroje instalace. K nastavení edice použijte parametr InstallPackageIndex.

K získání tohoto objektu použijte rutinu Get-CMOperatingSystemInstaller.

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

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

-InstallPackageIndex

Zadejte celočíselnou hodnotu edice balíčku s upgradem operačního systému. Tento parametr použijte s parametrem InstallPackage.

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

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

-Name

Zadejte název pro tento krok, který ho identifikuje v pořadí úkolů.

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

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

-RunFromNet

Nastavte tento parametr na , aby pořadí úkolů bylo možné použít image operačního $true systému přímo z distribučního bodu.

Pro zajištění nejvyššího zabezpečení se doporučuje toto nastavení nepopnout. Tato možnost je určená pro použití na zařízeních s omezenou kapacitou úložiště. Další informace najdete v tématu Přístup k obsahu přímo z distribučního bodu.

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

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

-WhatIf

Zobrazuje, co by se stalo při spuštění rutiny. Rutina se nespouštěl.

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

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

-LayeredDriver

Od verze 2107 můžete pomocí tohoto parametru vybrat další typy klávesnic, které jsou společné pro japonštinu a korejštinu. Zadejte celočíselnou hodnotu pro vrstvený ovladač, který se má nainstalovat Windows. Použijte stejné hodnoty jako proměnná pořadí úkolů OsdLayeredDriver.

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

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

CommonParameters

Tato rutina podporuje společné parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction a -WarningVariable. Další informace najdete v tématu about_CommonParameters.

INPUTS

Žádné

OUTPUTS

IResultObject#SMS_TaskSequence_ApplyOperatingSystemAction

POZNÁMKY

Další informace o tomto návratového objektu a jeho vlastnostech najdete v SMS_TaskSequence_ApplyOperatingSystemAction rozhraní WMI.

Get-CMTSStepApplyOperatingSystem Remove-CMTSStepApplyOperatingSystem Set-CMTSStepApplyOperatingSystem

O krocích pořadí úkolů: Použití image operačního systému