New-CMTSStepApplyDataImage

SYNOPSIS

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

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

To polecenie cmdlet tworzy nowy obiekt kroku Zastosuj obraz danych. 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 danych.

Uwaga

Uruchom Menedżer konfiguracji cmdlet z dysku 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 danych. Zapisuje ten obiekt w zmiennej $pkgDataImg . Następnym krokiem jest utworzenie obiektu dla kroku Zastosuj obraz danych przy użyciu obiektu $pkgDataImg jako pakietu obrazu.

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

-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

-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 w przypadku błędu. 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)

Podaj 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 obraz danych. Jeśli ten parametr nie zostanie określony, wartość domyślna to 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 i podziel dysk 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

Jeśli używasz -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 na Z .

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

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

-DestinationPartition

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

Jeśli używasz programu , użyj tego parametru, aby określić zmienną -Destination LogicalDriverLetterInVariable sekwencji zadań za pomocą litery dysku logicznego. Nazwa zmiennej musi być alfanumeryczna bez spacji i mniej 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 danych. Krok powoduje zastosowanie danych 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: True
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: True
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

-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

-WipePartition

To ustawienie jest domyślnie włączone, co powoduje usunięcie całej zawartości na partycji przed zastosowaniem obrazu.

Ustaw ten parametr na , $false aby nie usuwać poprzedniej zawartości partycji. Ta akcja może służyć do zastosowania większej zawartości do wcześniej docelowej partycji.

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

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_ApplyDataImageAction

UWAGI

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

RELATED LINKS

Get-CMTSStepApplyDataImage Remove-CMTSStepApplyDataImage Set-CMTSStepApplyDataImage

Informacje o krokach sekwencji zadań: Stosowanie obrazu danych