Delen via

New-CMTSStepApplyOperatingSystem

  • Artikel

SYNOPSIS

Maak een stap Besturingssysteemafbeelding toepassen die u aan een takenreeks kunt toevoegen.

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

Met deze cmdlet maakt u een nieuw stapobject Besturingssysteemafbeelding toepassen. Gebruik vervolgens de cmdlet Add-CMTaskSequenceStep om de stap toe te voegen aan een takenreeks. Zie Over takenreeksstappen: Besturingssysteemafbeelding 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 afbeeldingspakket van het besturingssysteem. Het slaat dit object op in de $osImgPkg variabele. In de volgende stap maakt u een -object voor de stap Besturingssysteemafbeelding toepassen, met behulp van het $osImgPkg-object als het afbeeldingspakket.

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

-Voorwaarde

Geef een voorwaardeobject op dat met deze stap moet worden gebruikt. Gebruik een van de cmdlets voor de 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

-ConfigFileName

Geef de bestandsnaam op van een installatie zonder toezicht of Sysprep-antwoordbestand moet worden gebruikt voor een aangepaste installatie. Gebruik deze parameter met de parameter ConfigFilePackage.

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

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

-ConfigFilePackage

Geef een pakketobject op dat de objecten zonder toezicht of Sysprep-antwoordbestand te gebruiken voor een aangepaste installatie. Gebruik de cmdlet Get-CMPackage om dit object op te halen. Gebruik deze parameter met de parameter ConfigFileName.

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

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 dit besturingssysteem wilt toepassen. Als u deze parameter niet opgeeft, is de standaardwaarde NextAvailableFormattedPartition .

  • NextAvailableFormattedPartition: Gebruik de volgende sequentiële partitie die nog niet 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 aan de partitie is toegewezen door Windows PE. Deze station letter kan verschillen van de letter station 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 op te geven met de logische-stationletter. 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 afbeeldingspakketobject van het besturingssysteem op. Met de stap wordt het besturingssysteem van 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: False
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: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-InstallPackage

Geef een upgradepakketobject voor het besturingssysteem op. Met de stap wordt het besturingssysteem van deze oorspronkelijke installatiebron toegepast. Gebruik de parameter InstallPackageIndex om de editie in te stellen.

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

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

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

-InstallPackageIndex

Geef een geheel getal op van de editie van het besturingssysteemupgradepakket. Gebruik deze parameter met de parameter InstallPackage.

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

Required: False
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

-RunFromNet

Stel deze parameter in op $true zodat de takenreeks de besturingssysteemafbeelding rechtstreeks vanaf het distributiepunt kan toepassen.

Voor de beste beveiliging is het raadzaam om deze instelling niet in te stellen. Deze optie is ontworpen voor gebruik op apparaten met beperkte opslagcapaciteit. Zie Inhoud rechtstreeks openen vanaf het distributiepunt voor meer informatie.

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

Required: False
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

-LayeredDriver

Vanaf versie 2107 gebruikt u deze parameter om andere typen toetsenborden te selecteren die gemeenschappelijk zijn in de Japanse en Koreaans taal. Geef een geheel getal op voor het gelaagde stuurprogramma dat moet worden geïnstalleerd met Windows. Gebruik dezelfde waarden als de takenreeksvariabele OsdLayeredDriver.

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

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_ApplyOperatingSystemAction

OPMERKINGEN

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

Get-CMTSStepApplyOperatingSystem Remove-CMTSStepApplyOperatingSystem Set-CMTSStepApplyOperatingSystem

Over takenreeksstappen: Besturingssysteemafbeelding toepassen