Dela via

New-CMTSStepApplyDataImage

  • Artikel

SYNOPSIS

Skapa steget Apply Data Image (Använd dataavbildning) som du kan lägga till i en aktivitetssekvens.

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

Den här cmdleten skapar ett nytt Apply Data Image step object (Tillämpa dataavbildningsstegobjekt). Använd sedan cmdleten Add-CMTaskSequenceStep för att lägga till steget i en aktivitetssekvens. Mer information om det här steget finns i Om aktivitetssekvenssteg: Använd dataavbildning.

Anteckning

Kör Konfigurationshanteraren cmdlets från Konfigurationshanteraren platsenheten, till exempel PS XYZ:\> . Mer information finns i Komma igång.

EXAMPLES

Exempel 1

I det här exemplet används först cmdleten Get-CMOperatingSystemImage för att hämta ett objekt för dataavbildningspaketet. Det här objektet sparas i $pkgDataImg variabeln. Nästa steg skapar ett -objekt för steget Tillämpa dataavbildning med hjälp $pkgDataImg-objektet som avbildningspaket.

Den hämtar sedan ett aktivitetssekvensobjekt och lägger till det här nya steget i aktivitetssekvensen vid index 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

-Condition

Ange ett villkorsobjekt som ska användas med det här steget. Hämta det här objektet genom att använda en av cmdletarna för aktivitetssekvensvillkor. Till exempel 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

Uppmanar dig att bekräfta innan du kör cmdleten.

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

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

-ContinueOnError

Lägg till den här parametern för att aktivera stegalternativet Fortsätt vid fel. Om steget misslyckas när du aktiverar det här alternativet fortsätter aktivitetssekvensen.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-Beskrivning

Ange en valfri beskrivning för det här aktivitetssekvenssteget.

Type: String
Parameter Sets: (All)
Aliases:

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

-Mål

Ange den plats där du vill tillämpa den här dataavbildningen. Om du inte anger den här parametern är standardvärdet NextAvailableFormattedPartition .

  • NextAvailableFormattedPartition: Använd nästa sekventiella partition som inte redan är mål för ett tillämpat operativsystem eller steget Använd dataavbildning i den här aktivitetssekvensen.

  • SpecificDiskAndPartition: Ange disknumret med parametern DestinationDisk och partitionsnumret med parametern DestinationPartition.

  • SpecificLogicalDriverLetter: Använd parametern DestinationDriveLetter för att ange den logiska enhetsbeteckning som tilldelats partitionen av Windows PE. Den här enhetsbeteckningen kan vara en annan än enhetsbeteckningen som tilldelats av det nyligen distribuerade operativsystemet.

  • LogicalDriverLetterInVariable: Använd parametern DestinationVariable för att ange aktivitetssekvensvariabeln som innehåller enhetsbeteckningen som tilldelats partitionen av Windows PE. Den här variabeln anges vanligtvis med parametern DiskNumberVariable för cmdletarna Set-CMTSStepPartitionDisk eller New-CMTSStepPartitionDisk för aktivitetssekvenssteget Format och Partition Disk.

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

När du använder -Destination SpecificDiskAndPartition använder du den här parametern för att ange disknumret. Ange ett heltal från 0 till 99 . Använd även parametern DestinationPartition.

Type: Int32
Parameter Sets: (All)
Aliases:

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

-DestinationDriveLetter

När du använder -Destination SpecificLogicalDriverLetter använder du den här parametern för att ange den logiska enhetsbeteckningen. Ange en enhetsbeteckning från C till Z .

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

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

-DestinationPartition

När du använder -Destination SpecificDiskAndPartition använder du den här parametern för att ange partitionsnumret. Ange ett heltal från 1 till 99 . Använd även parametern DestinationDisk.

Type: Int32
Parameter Sets: (All)
Aliases:

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

-DestinationVariable

När du använder -Destination LogicalDriverLetterInVariable använder du den här parametern för att ange aktivitetssekvensvariabeln med den logiska enhetsbeteckningen. Variabelnamnet måste vara alfanumeriskt utan blanksteg och färre än 256 tecken.

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

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

-Inaktivera

Lägg till den här parametern för att inaktivera det här aktivitetssekvenssteget.

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

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

-DisableWildcardHandling

Den här parametern behandlar jokertecken som värden för literaltecken. Du kan inte kombinera den med ForceWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-ForceWildcardHandling

Den här parametern bearbetar jokertecken och kan leda till oväntat beteende (rekommenderas inte). Du kan inte kombinera den med DisableWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-ImagePackage

Ange ett paketobjekt för dataavbildningen. Steget tillämpar data från den här avbildningen. Använd parametern ImagePackageIndex för att ange avbildningsindexet.

Hämta det här objektet med cmdleten Get-CMOperatingSystemImage.

Type: IResultObject
Parameter Sets: (All)
Aliases:

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

-ImagePackageIndex

Ange ett heltalsvärde för avbildningsindexet. Använd den här parametern med parametern ImagePackage.

Type: Int32
Parameter Sets: (All)
Aliases:

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

-Name

Ange ett namn för det här steget för att identifiera det i aktivitetssekvensen.

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

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

-WhatIf

Visar vad som skulle hända om cmdleten kördes. Cmdleten körs inte.

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

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

-WipePartition

Den här inställningen är aktiverad som standard, vilket tar bort allt innehåll på partitionen innan avbildningen tillämpas.

Ange den här $false parametern till för att inte ta bort det tidigare innehållet i partitionen. Den här åtgärden kan användas för att tillämpa mer innehåll på en tidigare riktad partition.

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

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

CommonParameters

Denna cmdlet har stöd för parametrarna -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.

INPUTS

Ingen

OUTPUTS

IResultObject#SMS_TaskSequence_ApplyDataImageAction

ANTECKNINGAR

Mer information om det här returobjektet och dess egenskaper finns i SMS_TaskSequence_ApplyDataImageAction serverns WMI-klass.

Get-CMTSStepApplyDataImage Remove-CMTSStepApplyDataImage Set-CMTSStepApplyDataImage

Om aktivitetssekvenssteg: Använd dataavbildning