New-CMTSStepApplyOperatingSystem

SYNOPSIS

Utwórz krok Zastosuj obraz systemu operacyjnego, który można dodać do sekwencji zadań.

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

To polecenie cmdlet tworzy nowy obiekt kroku Zastosuj obraz systemu operacyjnego. Następnie użyj polecenia cmdlet Add-CMTaskSequenceStep, aby dodać krok do sekwencji zadań. Aby uzyskać więcej informacji na temat tego kroku, zobacz Informacje o krokach sekwencji zadań: Stosowanie obrazu systemu operacyjnego.

Uwaga

Uruchom Menedżer konfiguracji cmdlet z Menedżer konfiguracji lokacji, na przykład PS XYZ:\> . Aby uzyskać więcej informacji, zobacz wprowadzenie.

EXAMPLES

Przykład 1

W tym przykładzie najpierw użyto polecenia cmdlet Get-CMOperatingSystemImage w celu uzyskania obiektu dla pakietu obrazu systemu operacyjnego. Zapisuje ten obiekt w $osImgPkg zmiennej . Następny krok powoduje utworzenie obiektu dla kroku Zastosuj obraz systemu operacyjnego przy użyciu obiektu $osImgPkg jako pakietu obrazu.

Następnie pobiera obiekt sekwencji zadań i dodaje ten nowy krok do sekwencji zadań pod indeksem 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

-Warunek

Określ obiekt warunku do użycia w tym kroku. Aby uzyskać ten obiekt, użyj jednego z polecenia cmdlet warunku sekwencji zadań. Na przykład 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

Określ nazwę pliku instalacji nienadzorowanej lub plik odpowiedzi Sysprep do użycia dla instalacji niestandardowej. Użyj tego parametru z parametrem ConfigFilePackage.

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

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

-ConfigFilePackage

Określ obiekt pakietu, który zawiera nienadzorowany lub plik odpowiedzi Sysprep do użycia w instalacji niestandardowej. Aby uzyskać ten obiekt, użyj polecenia cmdlet Get-CMPackage. Użyj tego parametru z parametrem ConfigFileName.

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

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

-Confirm

Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.

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

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

-ContinueOnError

Dodaj ten parametr, aby włączyć opcję kroku Kontynuuj przy błędzie. Jeśli ta opcja zostanie włączyć, jeśli krok zakończy się niepowodzeniem, sekwencja zadań będzie kontynuowana.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-Description (Opis)

Określ opcjonalny opis tego kroku sekwencji zadań.

Type: String
Parameter Sets: (All)
Aliases:

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

-Docelowej

Określ lokalizację, w której chcesz zastosować ten system operacyjny. Jeśli ten parametr nie zostanie określony, wartością domyślną będzie NextAvailableFormattedPartition .

• NextAvailableFormattedPartition: użyj następnej partycji sekwencyjnej, która nie jest jeszcze docelowa w kroku Zastosuj system operacyjny lub Zastosuj obraz danych w tej sekwencji zadań.

• SpecificDiskAndPartition: określ numer dysku za pomocą parametru DestinationDisk i numer partycji za pomocą parametru DestinationPartition.

• SpecificLogicalDriverLetter: użyj parametru DestinationDriveLetter, aby określić literę dysku logicznego przypisaną do partycji przez Windows PE. Ta litera dysku może różnić się od litery dysku przypisanej przez nowo wdrożony system operacyjny.

• LogicalDriverLetterInVariable: użyj parametru DestinationVariable, aby określić zmienną sekwencji zadań zawierającą literę dysku przypisaną do partycji przez Windows PE. Ta zmienna jest zwykle ustawiana za pomocą parametru DiskNumberVariable polecenia cmdlet Set-CMTSStepPartitionDisk lub New-CMTSStepPartitionDisk dla kroku sekwencji zadań Formatuj dysk i podziel go na partycje.

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

W przypadku użycia -Destination SpecificDiskAndPartition parametru użyj tego parametru, aby określić numer dysku. Określ liczbę całkowitą z 0 do 99 . Należy również użyć parametru DestinationPartition.

Type: Int32
Parameter Sets: (All)
Aliases:

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

-DestinationDriveLetter

Jeśli używasz -Destination SpecificLogicalDriverLetter , użyj tego parametru, aby określić literę dysku logicznego. Określ literę dysku z 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 (Partycja docelowa)

Jeśli używasz -Destination SpecificDiskAndPartition parametru , użyj tego parametru, aby określić numer partycji. Określ liczbę całkowitą z 1 do 99 . Użyj również parametru DestinationDisk.

Type: Int32
Parameter Sets: (All)
Aliases:

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

-DestinationVariable

W przypadku korzystania -Destination LogicalDriverLetterInVariable z programu użyj tego parametru, aby określić zmienną sekwencji zadań za pomocą litery dysku logicznego. Nazwa zmiennej musi być alfanumeryczna bez spacji i mniejsza niż 256 znaków.

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

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

-Wyłącz

Dodaj ten parametr, aby wyłączyć ten krok sekwencji zadań.

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

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

-DisableWildcardHandling

Ten parametr traktuje symbole wieloznaczne jako wartości literału znaków. Nie można połączyć go z forceWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-ForceWildcardHandling

Ten parametr przetwarza symbole wieloznaczne i może prowadzić do nieoczekiwanego zachowania (nie jest zalecane). Nie można połączyć go z disableWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-ImagePackage

Określ obiekt pakietu obrazu systemu operacyjnego. Ten krok powoduje zastosowanie systemu operacyjnego z tego obrazu. Użyj parametru ImagePackageIndex, aby ustawić indeks obrazu.

Aby uzyskać ten obiekt, użyj polecenia cmdlet Get-CMOperatingSystemImage.

Type: IResultObject
Parameter Sets: (All)
Aliases:

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

-ImagePackageIndex

Określ wartość całkowitą indeksu obrazu. Użyj tego parametru z parametrem ImagePackage.

Type: Int32
Parameter Sets: (All)
Aliases:

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

-InstallPackage

Określ obiekt pakietu uaktualnienia systemu operacyjnego. Ten krok powoduje zastosowanie systemu operacyjnego z tego oryginalnego źródła instalacji. Użyj parametru InstallPackageIndex, aby ustawić wersję.

Aby uzyskać ten obiekt, użyj polecenia cmdlet 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

Określ wartość całkowitą wersji pakietu uaktualnienia systemu operacyjnego. Użyj tego parametru z installPackage parametru.

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

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

-Name

Określ nazwę tego kroku, aby zidentyfikować ją w sekwencji zadań.

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

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

-RunFromNet

Ustaw ten parametr na , aby umożliwić sekwencji zadań zastosowanie obrazu $true systemu operacyjnego bezpośrednio z punktu dystrybucji.

Aby zapewnić największe bezpieczeństwo, nie zaleca się włączania tego ustawienia. Ta opcja jest przeznaczona do użytku na urządzeniach z ograniczoną pojemnością magazynu. Aby uzyskać więcej informacji, zobacz Access content directly from the distribution point.

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

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

-WhatIf

Pokazuje, co się stanie po uruchomieniu polecenia cmdlet. Polecenie cmdlet nie jest uruchamiane.

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

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

-LayeredDriver

Począwszy od wersji 2107 użyj tego parametru, aby wybrać inne typy klawiatur, które są wspólne dla języków japońskich i koreańskich. Określ wartość całkowitą dla sterownika warstwowego do zainstalowania za pomocą Windows. Użyj tych samych wartości co zmienna sekwencji zadań OsdLayeredDriver.

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

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

Typowe parametry

To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters.

INPUTS

Brak

OUTPUTS

IResultObject#SMS_TaskSequence_ApplyOperatingSystemAction

UWAGI

Aby uzyskać więcej informacji na temat tego obiektu zwracanego i jego właściwości, zobacz SMS_TaskSequence_ApplyOperatingSystemAction klasy WMI serwera.

RELATED LINKS

Get-CMTSStepApplyOperatingSystem Remove-CMTSStepApplyOperatingSystem Set-CMTSStepApplyOperatingSystem

Informacje o krokach sekwencji zadań: Stosowanie obrazu systemu operacyjnego