Dela via

New-CMTSStepApplyOperatingSystem

  • Artikel

SYNOPSIS

Skapa ett tillämpa os-avbildningssteg som du kan lägga till i en aktivitetssekvens.

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

Den här cmdleten skapar ett nytt apply OS Image step-objekt. 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 OS-avbildning.

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 OS-avbildningspaketet. Det här objektet sparas i $osImgPkg variabeln. Nästa steg skapar ett -objekt för steget Tillämpa OPERATIVSYSTEMavbildning med hjälp $osImgPkg-objektet som avbildningspaket.

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

-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

-ConfigFileName

Ange filnamnet för en obevakad eller Sysprep-svarsfil ska användas för en anpassad installation. Använd den här parametern med parametern ConfigFilePackage.

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

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

-ConfigFilePackage

Ange ett paketobjekt som innehåller den obevakade eller Sysprep-svarsfil som ska användas för en anpassad installation. Hämta det här objektet med cmdleten Get-CMPackage. Använd den här parametern med parametern ConfigFileName.

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

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 det här operativsystemet. 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 objekt för os-avbildningspaket. Steget tillämpar operativsystemet 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: False
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: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-InstallPackage

Ange ett objekt för os-uppgraderingspaket. Steget tillämpar operativsystemet från den ursprungliga installationskällan. Använd parametern InstallPackageIndex för att ange versionen.

Hämta det här objektet med cmdleten 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

Ange ett heltalsvärde för versionen av OS-uppgraderingspaketet. Använd den här parametern med parametern InstallPackage.

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

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

-RunFromNet

Ange den här $true parametern till så att aktivitetssekvensen kan tillämpa OS-avbildningen direkt från distributionsplatsen.

För bästa möjliga säkerhet rekommenderar vi att du inte aktiverar den här inställningen. Det här alternativet är utformat för användning på enheter med begränsad lagringskapacitet. Mer information finns i Åtkomst till innehåll direkt från distributionsplatsen.

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

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

-LayeredDriver

Från och med version 2107 använder du den här parametern för att välja andra typer av tangentbord som är vanliga med japanska och koreanska språk. Ange ett heltalsvärde för den layered-drivrutin som ska installeras med Windows. Använd samma värden som aktivitetssekvensvariabeln OsdLayeredDriver.

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

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_ApplyOperatingSystemAction

ANTECKNINGAR

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

Get-CMTSStepApplyOperatingSystem Remove-CMTSStepApplyOperatingSystem Set-CMTSStepApplyOperatingSystem

Om aktivitetssekvenssteg: Använd OS-avbildning