Get-CMWinPEOptionalComponentInfo

  • Riferimento
Modulo:
ConfigurationManager

Ottenere un componente facoltativo di Windows PE.

Sintassi

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

Descrizione

Usare questo cmdlet per ottenere un componente facoltativo di Windows PE (WinPE). Usare questo oggetto per aggiungerlo o rimuoverlo da un'immagine di avvio con il cmdlet Set-CMBootImage . Per altre informazioni, vedere Gestire le immagini di avvio - Componenti facoltativi.

Nota

Eseguire i cmdlet di Configuration Manager dall'unità del sito di Configuration Manager, ad esempio PS XYZ:\>. Per altre informazioni, vedere Introduzione.

Esempio

Esempio 1: Ottenere componenti facoltativi e aggiungere a un'immagine di avvio

Questo esempio ottiene i componenti facoltativi di .NET e PowerShell e li aggiunge a un'immagine di avvio.

$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

Parametri

-Architecture

Specificare l'architettura di un componente facoltativo WinPE.

Tipo:String
Valori accettati:X64, X86
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-DisableWildcardHandling

Questo parametro considera i caratteri jolly come valori letterali. Non è possibile combinarlo con ForceWildcardHandling.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ForceWildcardHandling

Questo parametro elabora caratteri jolly e può causare un comportamento imprevisto (non consigliato). Non è possibile combinarlo con DisableWildcardHandling.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-LanguageId

Specificare l'ID lingua per il componente facoltativo.

Questo ID è l'equivalente decimale dell'ID lingua windows. Ad esempio, 1033 è 0x0409 per l'inglese (Stati Uniti) e 2070 per 0x0816il portoghese (Portogallo). Per altre informazioni, vedere [MS-LCID]: Informazioni di riferimento sull'identificatore LCID (Windows Language Code Identifier).

Configuration Manager supporta 22 lingue. Per altre informazioni, vedere Lingue client.

Tipo:UInt32
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Name

Specificare il nome del componente facoltativo WinPE da ottenere.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:True

-UniqueId

Specificare l'ID univoco del componente facoltativo WinPE da ottenere.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

Input

None

Output

IResultObject[]

IResultObject

Note

Per altre informazioni su questo oggetto restituito e sulle relative proprietà, vedere SMS_WinPEOptionalComponentInfo classe WMI del server.