Dela via


Get-CMWinPEOptionalComponentInfo

SYNOPSIS

Hämta en Windows PE-valfri komponent.

SYNTAX

SearchByName (standard)

Get-CMWinPEOptionalComponentInfo -Architecture <String> [-LanguageId <UInt32>] [-Name <String>]
 [-DisableWildcardHandling] [-ForceWildcardHandling] [<CommonParameters>]

SearchById

Get-CMWinPEOptionalComponentInfo -UniqueId <String> [-DisableWildcardHandling] [-ForceWildcardHandling]
 [<CommonParameters>]

DESCRIPTION

Använd denna cmdlet för att hämta en valfri Windows PE (WinPE). Använd det här objektet för att lägga till eller ta bort det från en startavbildning med cmdleten Set-CMBootImage. Mer information finns i Hantera startavbildningar – Valfria komponenter.

Anteckning

Kör Konfigurationshanteraren cmdlets från Konfigurationshanteraren platsenheten, till exempel PS XYZ:\> . Mer information finns i Komma igång.

EXAMPLES

Exempel 1: Hämta valfria komponenter och lägg till i en startavbildning

Det här exemplet hämtar de valfria komponenterna .NET och PowerShell och lägger sedan till dem i en startavbildning.

$netfxOC = Get-CMWinPEOptionalComponentInfo -Architecture 'x64' -Name 'WinPE-NetFX' -LanguageId 1033
$pwshOC = Get-CMWinPEOptionalComponentInfo -Architecture 'x64' -Name 'WinPE-PowerShell' -LanguageId 1033
$OCs = @($netfxOC, $pwshOC)

Set-CMBootImage -Id 'XYZ00556' -AddOptionalComponent $OCs

PARAMETERS

-Arkitektur

Ange arkitekturen för en valfri WinPE-komponent.

Type: String
Parameter Sets: SearchByName
Aliases:
Accepted values: X64, X86

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

-LanguageId

Ange språk-ID för den valfria komponenten.

Det här ID:t är decimalvärdet för Windows språk-ID: t. Till exempel 1033 är för engelska 0x0409 (USA) och 2070 är för portugisiska 0x0816 (Portugal). Mer information finns i [MS-LCID]: Windows LCID-referens (Language Code Identifier).

Konfigurationshanteraren stöder 22 språk. Mer information finns i Klientspråk.

Type: UInt32
Parameter Sets: SearchByName
Aliases:

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

-Name

Ange namnet på den valfria WinPE-komponenten som ska hämtas.

Type: String
Parameter Sets: SearchByName
Aliases:

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

-UniqueId

Ange det unika ID:t för den valfria WinPE-komponenten som ska hämtas.

Type: String
Parameter Sets: SearchById
Aliases:

Required: True
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_WinPEOptionalComponentInfo

IResultObject#SMS_WinPEOptionalComponentInfo

ANTECKNINGAR

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

Set-CMBootImage

Hantera startavbildningar – valfria komponenter