Sdílet prostřednictvím

New-CMTSStepApplyDataImage

  • Článek

SYNOPSIS

Vytvoří krok použít bitovou kopii dat , který můžete přidat do pořadí úkolů.

SYNTAX

New-CMTSStepApplyDataImage [-Destination <DestinationType>] [-DestinationDisk <Int32>]
 [-DestinationDriveLetter <String>] [-DestinationPartition <Int32>] [-DestinationVariable <String>]
 -ImagePackage <IResultObject> -ImagePackageIndex <Int32> [-WipePartition <Boolean>]
 [-Condition <IResultObject[]>] [-ContinueOnError] [-Description <String>] [-Disable] -Name <String>
 [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]

DESCRIPTION

Tato rutina vytvoří nový objekt kroku použít bitovou kopii dat . Pak pomocí rutiny Add-CMTaskSequenceStep přidejte krok do pořadí úkolů. Další informace o tomto kroku naleznete v části o krocích pořadí úkolů: použít data image.

Poznámka

Použijte například rutiny Configuration Manager z Configuration Manager jednotky webu PS XYZ:\> . Další informace najdete v tématu Začínáme.

EXAMPLES

Příklad 1

Tento příklad nejprve pomocí rutiny Get-CMOperatingSystemImage Získá objekt pro balíček bitové kopie dat. Uloží tento objekt do proměnné $pkgDataImg . V dalším kroku se vytvoří objekt pro krok použít data image pomocí objektu $pkgDataImg jako balíčku bitové kopie.

Pak získá objekt pořadí úloh a přidá tento nový krok do pořadí úkolů v indexu 11.

$pkgDataImg = Get-CMOperatingSystemImage -Name "Data image"
$step = New-CMTSStepApplyDataImage -Name "Apply data image" -ImagePackage $pkgDataImg -ImagePackageIndex 1

$tsName = "Custom task sequence"
$ts = Get-CMTaskSequence -Name $tsName -Fast

$ts | Add-CMTaskSequenceStep -Step $step -InsertStepStartIndex 11

PARAMETERS

-Podmínka

Zadejte objekt podmínky, který se použije v tomto kroku. Chcete-li získat tento objekt, použijte jednu z rutin pro podmínky 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

-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řidejte tento parametr, aby bylo možné povolit možnost kroku pokračovat při chybě. Pokud tuto možnost povolíte, pořadí úkolů bude pokračovat i v případě, že se krok nezdařil.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-Description

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

– Cíl

Zadejte umístění, kde chcete použít tuto bitovou kopii dat. Pokud tento parametr nezadáte, použije se výchozí hodnota NextAvailableFormattedPartition .

  • NextAvailableFormattedPartition: Použijte další sekvenční oddíl, který se už nezaměřuje na krok použít operační systém nebo použít pro obrázek data v tomto pořadí úkolů.

  • SpecificDiskAndPartition: Zadejte číslo disku s parametrem DestinationDisk a číslem oddílu s parametrem DestinationPartition .

  • SpecificLogicalDriverLetter: pomocí parametru DestinationDriveLetter můžete zadat 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 zadejte proměnnou pořadí úkolů obsahující písmeno jednotky přiřazené oddílu Windows PE. Tato proměnná se obvykle nastavuje pomocí parametru DiskNumberVariable rutin 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

Když 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

Když použijete -Destination SpecificLogicalDriverLetter , použijte tento parametr k zadání písmene 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

Když 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

Když použijete -Destination LogicalDriverLetterInVariable Tento parametr, můžete zadat proměnnou pořadí úloh s písmenem logické jednotky. Název proměnné musí být alfanumerický, bez mezer a kratší 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

– Zakázat

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

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 jako literálové hodnoty znaků. Nejde 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čujeme). Nejde kombinovat s 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 bitové kopie dat. Tento krok aplikuje data z tohoto obrázku. 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: True
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 spolu s parametrem ImagePackage .

Type: Int32
Parameter Sets: (All)
Aliases:

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

-Name

Zadejte název pro tento krok, abyste ho identifikovali 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

-WhatIf

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

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

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

-WipePartition

Toto nastavení je ve výchozím nastavení povolené, což před použitím image odstraní veškerý obsah v oddílu.

Nastavením tohoto parametru na $false neodstraníte předchozí obsah oddílu. Tuto akci lze použít k použití většího obsahu na dříve cílený oddíl.

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

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_ApplyDataImageAction

POZNÁMKY

Další informace o tomto návratovém objektu a jeho vlastnostech naleznete v tématu SMS_TaskSequence_ApplyDataImageAction serverové třídy služby WMI.

Get-CMTSStepApplyDataImage Remove-CMTSStepApplyDataImage Set-CMTSStepApplyDataImage

Kroky pořadí úkolů: použít data bitové kopie