Delen via

New-CMTSStepApplyDataImage

  • Artikel

SYNOPSIS

Maak een stap Gegevensafbeelding toepassen, die u aan een takenreeks kunt toevoegen.

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

Met deze cmdlet maakt u een nieuw stapobject Gegevensafbeelding toepassen. Gebruik vervolgens de cmdlet Add-CMTaskSequenceStep om de stap toe te voegen aan een takenreeks. Zie Over takenreeksstappen: Gegevensafbeelding toepassen voor meer informatie over deze stap.

Notitie

Voer Configuration Manager cmdlets uit vanaf Configuration Manager sitestation, bijvoorbeeld PS XYZ:\> . Zie Aan de slag voor meer informatie.

EXAMPLES

Voorbeeld 1

In dit voorbeeld wordt eerst de cmdlet Get-CMOperatingSystemImage gebruikt om een -object op te halen voor het gegevensinstallatiepakket. Dit object wordt op de $pkgDataImg op slaat. In de volgende stap maakt u een -object voor de stap Gegevensafbeelding toepassen, met behulp van het $pkgDataImg-object als het afbeeldingspakket.

Vervolgens wordt een takenreeksobject gemaakt en wordt deze nieuwe stap toegevoegd aan de takenreeks op 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

-Voorwaarde

Geef een voorwaardeobject op dat met deze stap moet worden gebruikt. Gebruik een van de cmdlets voor takenreeksvoorwaarde om dit object op te halen. Bijvoorbeeld 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

Hiermee wordt u gevraagd om bevestiging voordat u de cmdlet uitvoert.

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

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

-ContinueOnError

Voeg deze parameter toe om de stapoptie Doorgaan bij fout in teschakelen. Wanneer u deze optie inschakelen als de stap mislukt, wordt de takenreeks voortgezet.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-Beschrijving

Geef een optionele beschrijving op voor deze takenreeksstap.

Type: String
Parameter Sets: (All)
Aliases:

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

-Doel

Geef de locatie op waar u deze gegevensafbeelding wilt toepassen. Als u deze parameter niet opgeeft, is de standaardwaarde NextAvailableFormattedPartition .

  • NextAvailableFormattedPartition: Gebruik de volgende sequentiële partitie die niet al is gericht op een stap Besturingssysteem toepassen of Gegevensinstallatie afbeelding toepassen in deze takenreeks.

  • SpecificDiskAndPartition: Geef het schijfnummer op met de parameter DestinationDisk en het partitienummer met de parameter DestinationPartition.

  • SpecificLogicalDriverLetter: Gebruik de parameter DestinationDriveLetter om de logische stationletter op te geven die is toegewezen aan de partitie door Windows PE. Deze letter kan verschillen van de letter van het station die is toegewezen door het zojuist geïmplementeerde besturingssysteem.

  • LogicalDriverLetterInVariable: Gebruik de parameter DestinationVariable om de takenreeksvariabele op te geven die de stationletter bevat die is toegewezen aan de partitie door Windows PE. Deze variabele wordt doorgaans ingesteld met de parameter DiskNumberVariable van de cmdlets Set-CMTSStepPartitionDisk of New-CMTSStepPartitionDisk voor de takenreeksstap Format and 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

Wanneer u -Destination SpecificDiskAndPartition gebruikt, gebruikt u deze parameter om het schijfnummer op te geven. Geef een geheel getal op van 0 tot 99 . Gebruik ook de parameter DestinationPartition.

Type: Int32
Parameter Sets: (All)
Aliases:

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

-DestinationDriveLetter

Wanneer u -Destination SpecificLogicalDriverLetter gebruikt, gebruikt u deze parameter om de logische stationletter op te geven. Geef een stationletter op van C naar Z .

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

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

-DestinationPartition

Wanneer u -Destination SpecificDiskAndPartition gebruikt, gebruikt u deze parameter om het partitienummer op te geven. Geef een geheel getal op van 1 tot 99 . Gebruik ook de parameter DestinationDisk.

Type: Int32
Parameter Sets: (All)
Aliases:

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

-DestinationVariable

Wanneer u -Destination LogicalDriverLetterInVariable gebruikt, gebruikt u deze parameter om de takenreeksvariabele met de logische-stationletter op te geven. De naam van de variabele moet alfanumeriek zijn zonder spaties en minder dan 256 tekens.

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

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

-Uitschakelen

Voeg deze parameter toe om deze takenreeksstap uit te schakelen.

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

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

-DisableWildcardHandling

Deze parameter behandelt jokertekens als letterlijke tekenwaarden. U kunt deze niet combineren met ForceWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-ForceWildcardHandling

Deze parameter verwerkt jokertekens en kan leiden tot onverwacht gedrag (niet aanbevolen). U kunt deze niet combineren met DisableWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-ImagePackage

Geef een pakketobject voor de gegevensafbeelding op. Met de stap worden de gegevens uit deze afbeelding toegepast. Gebruik de parameter ImagePackageIndex om de afbeeldingsindex in te stellen.

Gebruik de cmdlet Get-CMOperatingSystemImage om dit object op te halen.

Type: IResultObject
Parameter Sets: (All)
Aliases:

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

-ImagePackageIndex

Geef een geheel getal van de afbeeldingsindex op. Gebruik deze parameter met de parameter ImagePackage.

Type: Int32
Parameter Sets: (All)
Aliases:

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

-Name

Geef een naam op voor deze stap om deze in de takenreeks te identificeren.

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

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

-WhatIf

Hiermee wordt weergegeven wat er zou gebeuren als u de cmdlet uitvoert. De cmdlet wordt niet uitgevoerd.

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

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

-WipePartition

Deze instelling is standaard ingeschakeld, waardoor alle inhoud op de partitie wordt verwijderd voordat de afbeelding wordt toegepast.

Stel deze parameter in op $false om de eerdere inhoud van de partitie niet te verwijderen. Deze actie kan worden gebruikt om meer inhoud toe te passen op een eerder gerichte partitie.

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

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

CommonParameters

Deze cmdlet biedt ondersteuning voor de meest gebruikte parameters: -Debug, - ErrorAction, - ErrorVariable, - InformationAction, -InformationVariable, - OutVariable,-OutBuffer, - PipelineVariable - Verbose, - WarningAction en -WarningVariable. Zie voor meer informatie about_CommonParameters.

INPUTS

Geen

OUTPUTS

IResultObject#SMS_TaskSequence_ApplyDataImageAction

OPMERKINGEN

Zie WMI-klasse SMS_TaskSequence_ApplyDataImageAction server voor meer informatie over dit retourobject en deeigenschappen ervan.

Get-CMTSStepApplyDataImage Remove-CMTSStepApplyDataImage Set-CMTSStepApplyDataImage

Over takenreeksstappen: Gegevensafbeelding toepassen