Sdílet prostřednictvím


Set-CMBootImage

SYNOPSIS

Upravte spouštěcí image operačního systému.

SYNTAX

SetByValueMandatory (výchozí)

Set-CMBootImage [-AddOptionalComponent <IResultObject[]>] [-BackgroundBitmapPath <String>]
 [-CopyToPackageShareOnDistributionPoint <Boolean>] [-CustomPackageShareName <String>]
 [-DeployFromPxeDistributionPoint <Boolean>] [-Description <String>]
 [-DisconnectUserFromDistributionPoint <Boolean>] [-DisconnectUserFromDistributionPointMins <UInt32>]
 [-DisconnectUserFromDistributionPointRetryCount <UInt32>] [-DistributionPointUpdateSchedule <IResultObject>]
 [-EnableBinaryDeltaReplication <Boolean>] [-EnableCommandSupport <Boolean>] [-EnablePrestartCommand <Boolean>]
 [-Force] [-IncludeFilesForPrestart <Boolean>] [-InputLocale <String>] -InputObject <IResultObject>
 [-NewName <String>] [-PassThru] [-Path <String>] [-PersistContentInCache <Boolean>]
 [-PrestageBehavior <PrestageBehavior>] [-PrestartCommandLine <String>]
 [-PrestartIncludeFilesDirectory <String>] [-Priority <Priority>] [-Reload]
 [-RemoveOptionalComponent <IResultObject[]>] [-ScratchSpace <UInt32>]
 [-SendToPreferredDistributionPoint <Boolean>] [-Version <String>] [-DisableWildcardHandling]
 [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]

SetById

Set-CMBootImage [-AddOptionalComponent <IResultObject[]>] [-BackgroundBitmapPath <String>]
 [-CopyToPackageShareOnDistributionPoint <Boolean>] [-CustomPackageShareName <String>]
 [-DeployFromPxeDistributionPoint <Boolean>] [-Description <String>]
 [-DisconnectUserFromDistributionPoint <Boolean>] [-DisconnectUserFromDistributionPointMins <UInt32>]
 [-DisconnectUserFromDistributionPointRetryCount <UInt32>] [-DistributionPointUpdateSchedule <IResultObject>]
 [-EnableBinaryDeltaReplication <Boolean>] [-EnableCommandSupport <Boolean>] [-EnablePrestartCommand <Boolean>]
 [-Force] -Id <String> [-IncludeFilesForPrestart <Boolean>] [-InputLocale <String>] [-NewName <String>]
 [-PassThru] [-Path <String>] [-PersistContentInCache <Boolean>] [-PrestageBehavior <PrestageBehavior>]
 [-PrestartCommandLine <String>] [-PrestartIncludeFilesDirectory <String>] [-Priority <Priority>] [-Reload]
 [-RemoveOptionalComponent <IResultObject[]>] [-ScratchSpace <UInt32>]
 [-SendToPreferredDistributionPoint <Boolean>] [-Version <String>] [-DisableWildcardHandling]
 [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]

SetByName

Set-CMBootImage [-AddOptionalComponent <IResultObject[]>] [-BackgroundBitmapPath <String>]
 [-CopyToPackageShareOnDistributionPoint <Boolean>] [-CustomPackageShareName <String>]
 [-DeployFromPxeDistributionPoint <Boolean>] [-Description <String>]
 [-DisconnectUserFromDistributionPoint <Boolean>] [-DisconnectUserFromDistributionPointMins <UInt32>]
 [-DisconnectUserFromDistributionPointRetryCount <UInt32>] [-DistributionPointUpdateSchedule <IResultObject>]
 [-EnableBinaryDeltaReplication <Boolean>] [-EnableCommandSupport <Boolean>] [-EnablePrestartCommand <Boolean>]
 [-Force] [-IncludeFilesForPrestart <Boolean>] [-InputLocale <String>] -Name <String> [-NewName <String>]
 [-PassThru] [-Path <String>] [-PersistContentInCache <Boolean>] [-PrestageBehavior <PrestageBehavior>]
 [-PrestartCommandLine <String>] [-PrestartIncludeFilesDirectory <String>] [-Priority <Priority>] [-Reload]
 [-RemoveOptionalComponent <IResultObject[]>] [-ScratchSpace <UInt32>]
 [-SendToPreferredDistributionPoint <Boolean>] [-Version <String>] [-DisableWildcardHandling]
 [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]

DESCRIPTION

Tuto rutinu použijte k úpravě spouštěcí image operačního systému. Spouštěcí bitové kopie Windows předinstalačním prostředím (Windows PE), do kterých můžete spustit klientský počítač před instalací operačního systému.

Ovladače zařízení můžete přidat do spouštěcí image nebo změnit její vlastnosti. Než budete moci přidat nový ovladač zařízení, musíte ho nejprve naimportovat do katalogu Správce konfigurace ovladače a povolit ho.

Každá verze Správce konfigurace podporuje konkrétní verzi sady Windows Assessment and Deployment Kit (Windows ADK). Pokud jsou spouštěcí image založené na verzi prostředí Windows PE z podporované verze sady Windows ADK, můžete je upravit.

Další informace najdete v tématu Správa spouštěcích imagí pomocí Správce konfigurace.

Poznámka

Spusťte Správce konfigurace rutiny z Správce konfigurace lokality, například PS XYZ:\> . Další informace najdete v tématu Začínáme.

EXAMPLES

Příklad 1: Přejmenování spouštěcí image

Tento příkaz získá spouštěcí image podle ID balíčku a pak ji přejmenuje.

Set-CMBootimage -Id "CM100004" -NewName "Custom boot image"

Příklad 2: Nastavení popisných vlastností

Tento příkaz získá spouštěcí image podle názvu a pak do ní přidá verzi a popis.

Set-CMBootImage -Name "Custom boot image (x64)" -Version "Contoso v2.1" -Description "Managed by jqpublic"

Příklad 3: Nastavení rozložení klávesnice

Následující příklad nastaví výchozí rozložení klávesnice spouštěcí image na ruštinu (Ruština). Identifikuje spouštěcí image podle jejího ID.

Set-CMBootimage -Id "CM100004" -InputLocale "ru-ru"

Příklad 4: Přidání volitelných komponent

Tento příklad získá volitelné komponenty .NET a PowerShellu a pak je přidá do spouštěcí image.

$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

-AddOptionalComponent

Zadejte pole volitelných objektů komponent, které se mají přidat do spouštěcí image. K získání tohoto objektu použijte rutinu Get-CMWinPEOptionalComponentInfo.

Běžně se používají následující komponenty:

  • technologie Microsoft .NET (WinPE-NetFX): Tato komponenta je předpokladem pro PowerShell. Je to jedna z větších volitelných komponent.
  • Windows PowerShell (WinPE-PowerShell): Tato komponenta vyžaduje .NET a přidává omezenou podporu PowerShellu. Pokud během fáze prostředí WinPE pořadí úkolů spustíte vlastní skripty PowerShellu, přidejte tuto komponentu. Existují další komponenty, které mohou být vyžadovány pro jiné rutiny PowerShellu.
  • HTML (WinPE-HTA): Pokud vlastní aplikace HTML spustíte během fáze prostředí WinPE pořadí úkolů, přidejte tuto komponentu.

Další informace najdete v tématu Správa spouštěcích imagí – volitelné součásti.

Type: IResultObject[]
Parameter Sets: (All)
Aliases: AddOptionalComponents

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

-BackgroundBitmapPath

Zadejte cestu k síťovému souboru vlastního souboru image na pozadí, který se má použít v Windows PE.

Type: String
Parameter Sets: (All)
Aliases:

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

-Confirm

Před spuštěním rutiny zobrazí výzvu k potvrzení.

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

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

-CopyToPackageShareOnDistributionPoint

Klienti mohou vždycky stáhnout spouštěcí bitovou kopii z distribučního bodu. Pokud tento parametr nastavíte na $true, bude tato lokalita dostupná prostřednictvím pojmenované sdílené síťové složky v distribučních bodech. K zadání vlastního názvu sdílené složky použijte CustomPackageShareName.

Když tuto možnost povolíte, bude v distribučních bodech potřeba více místa. Platí pro všechny distribuční body, do kterých tuto spouštěcí bitovou kopii distribuujete.

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

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

-CustomPackageShareName

Pokud povolíte CopyToPackageShareOnDistributionPoint, můžete tento parametr použít k přizpůsobení názvu sdílené složky. Maximální délka je 127 znaků a nemůže obsahovat žádný z následujících znaků: " / [ ] : | < > + = ; , ? * . Můžete zadat název sdílené složky a název složky, ale maximální délka každé z nich je 80 znaků. Například, ShareName\FolderName.

Type: String
Parameter Sets: (All)
Aliases:

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

-DeployFromPxeDistributionPoint

Tento parametr nastavte $true, aby byla tato spouštěcí image dostupná z distribučního bodu s povoleným PXE. Další informace naleznete v části Use PXE to deploy Windows over the network.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-Description (Popis)

Zadejte volitelný popis spouštěcí bitové kopie, který vám pomůže ji identifikovat.

Type: String
Parameter Sets: (All)
Aliases:

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

-DisableWildcardHandling

Tento parametr považuje zástupné znaky za hodnoty literálových znaků. Nemůžete ho kombinovat s forceWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-DisconnectUserFromDistributionPoint

Tato možnost je zastaralá. Nastaví vlastnost ForcedDisconnectEnabled spouštěcí image.

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

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

-DisconnectUserFromDistributionPointMins

Tato možnost je zastaralá. Nastaví vlastnost ForcedDisconnectDelay spouštěcí image.

Type: UInt32
Parameter Sets: (All)
Aliases: DisconnectUsersFromDistributionPointsMinutes

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

-DisconnectUserFromDistributionPointRetryCount

Tato možnost je zastaralá. Nastaví vlastnost ForcedDisconnectNumRetries spouštěcí image.

Type: UInt32
Parameter Sets: (All)
Aliases: DisconnectUsersFromDistributionPointsRetries

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

-DistributionPointUpdateSchedule

Tento parametr použijte k aktualizaci distribučních bodů podle plánu. Pokud chcete získat objekt schedule, použijte rutinu New-CMSchedule.

Type: IResultObject
Parameter Sets: (All)
Aliases:

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

-EnableBinaryDeltaReplication

Pokud chcete povolit binární rozdílovou replikaci (BDR$true tento parametr nastavte na hodnotu . Další informace najdete v tématu Základní koncepty správy obsahu v Správce konfigurace.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-EnableCommandSupport

V neprodukcích a pouze v testovacích prostředích můžete tento parametr nastavit tak, $true podporu příkazů povolit. Když se zařízení spustí s tímto obrázkem, můžete stisknutím klávesy F8 otevřít příkazový řádek pro správu. Tato možnost je užitečná při řešení potíží při testování nasazení. Použití tohoto nastavení v produkčním nasazení se nedoporučuje z důvodu problémů se zabezpečením.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-EnablePrestartCommand

Nastavte tento parametr na $true a povolte předspouštěcí příkaz. Tento příkazový řádek se spustí před zahájením pořadí úkolů.

Nakonfigurujte také následující parametry: IncludeFilesForPrestart, PrestartCommandLine, PrestartIncludeFilesDirectory.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-Force

Spusťte příkaz bez předchozího potvrzení.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-ForceWildcardHandling

Tento parametr zpracovává zástupné znaky a může vést k neočekávanému chování (nedoporučuje se). Nemůžete ho kombinovat s příkazem DisableWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-Id

Zadejte ID spouštěcí image, která se má nakonfigurovat. Tato hodnota je standardní ID balíčku, například: XYZ00002 .

Type: String
Parameter Sets: SetById
Aliases: PackageId

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

-IncludeFilesForPrestart

Pokud povolíte EnablePrestartCommand, použijte tento parametr, pokud předspouštěcí příkaz vyžaduje spuštění dalších souborů. Pak pomocí parametru PrestartIncludeFilesDirectory určete umístění souborů, které se mají zahrnout.

Pokud například chcete spustit dávkový skript, použijte tuto možnost k zahrnutí souboru skriptu.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-InputLocale

Tento parametr použijte ke konfiguraci výchozího rozložení klávesnice pro spouštěcí bitovou kopii. Zadejte značku jazyka. Pokud chcete například nastavit vstupní národní prostředí na ruštinu (Ruština), zadejte řetězec ru-ru . Další informace najdete v tématu [MS-LCID]: referenční Windows LCID (Language Code Identifier).

Type: String
Parameter Sets: (All)
Aliases:

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

-InputObject

Zadejte objekt spouštěcí bitové kopie, který chcete konfigurovat. K získání tohoto objektu použijte rutinu Get-CMBootImage.

Type: IResultObject
Parameter Sets: SetByValueMandatory
Aliases:

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

-Name

Zadejte název spouštěcí image, která se má nakonfigurovat.

Type: String
Parameter Sets: SetByName
Aliases:

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

-NewName

Zadejte nový název spouštěcí image.

Type: String
Parameter Sets: (All)
Aliases:

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

-PassThru

Přidáním tohoto parametru vrátíte objekt, který představuje položku, se kterou pracujete. Ve výchozím nastavení tato rutina nemusí generovat žádný výstup.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-Path

Zadejte síťovou cestu k bitové kopii Windows PE, kterou tato spouštěcí image používá. Cestu pro výchozí spouštěcí image nemůžete změnit.

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

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

-PersistContentInCache

Pokud nechcete, aby obsah tohoto balíčku ztárouval z mezipaměti klienta, abyste měli místo pro jiný obsah, nastavte tento parametr na hodnotu $true, aby se uchová v mezipaměti klienta.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-PrestageBehavior

Zadejte chování při povolení distribučního bodu pro předzpracovaný obsah:

  • ManualCopy: Ručně zkopírujte obsah tohoto balíčku do distribučního bodu.
  • DownloadDelta: Stažení změn obsahu pouze do distribučního bodu
  • OnDemand: Automaticky stahovat obsah, když jsou balíčky přiřazeny k distribučním bodům

Další informace najdete v tématu Použití předzpracovaných obsahu.

Type: PrestageBehavior
Parameter Sets: (All)
Aliases:
Accepted values: ManualCopy, DownloadDelta, OnDemand

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

-PrestartCommandLine

Pokud povolíte EnablePrestartCommand, pomocí tohoto parametru určete příkazový řádek, který se má spustit. Maximální délka je 4 096 znaků.

Pokud příkazový řádek vyžaduje soubory, které nejsou v Windows PE, použijte parametry IncludeFilesForPrestart a PrestartIncludeFilesDirectory.

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

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

-PrestartIncludeFilesDirectory

Pokud povolíte EnablePrestartCommand a IncludeFilesForPrestart, použijte tento parametr k určení síťové cesty k souborům, které se mají zahrnout do spouštěcí image.

Type: String
Parameter Sets: (All)
Aliases:

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

-Priority (Priorita)

Určete pořadí, ve kterém bude lokalita odesílán obsah do jiných lokalit a distribučních bodů v této lokalitě.

Web odesílá obsah s vysokou prioritou před balíčky se střední nebo nízkou prioritou. Balíčky se stejnou prioritou se odesílat v pořadí, ve kterém jsou vytvořeny.

Type: Priority
Parameter Sets: (All)
Aliases:
Accepted values: High, Medium, Low

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

-Reload (Znovu načíst)

Platí pro verzi 2006 a novější. Pokud jsou verze součástí sady Windows ADK ve spouštěcí ibitové kopii zastaralé, přidejte tento parametr pro opětovné načtení spouštěcí bitové kopie s aktuální verzí Windows PE ze sady Windows ADK. Další informace najdete v tématu Aktualizace distribučních bodů pomocí spouštěcí image.

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

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

-RemoveOptionalComponent

Zadejte pole volitelných objektů součástí, které se mají odebrat ze spouštěcí image. K získání tohoto objektu použijte rutinu Get-CMWinPEOptionalComponentInfo.

Neodeberete následující součásti, které jsou vyžadovány Správce konfigurace:

  • Skriptování (skriptování prostředí WinPE)
  • Spuštění (WinPE-SecureStartup)
  • Síť (WinPE-WDS-Tools)
  • Skriptování (WinPE-WMI)
Type: IResultObject[]
Parameter Sets: (All)
Aliases: RemoveOptionalComponents

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

-ScratchSpace

Nakonfigurujte pomocné místo systému Windows PE. Je to dočasné úložiště (jednotka RAM) používané prostředím WinPE. Když třeba v systému WinPE běží určitá aplikace a potřebuje zapisovat dočasné soubory, systém WinPE přesměruje tyto soubory na pomocné místo v paměti, aby simuloval přítomnost pevného disku. Ve výchozím nastavení je tato velikost 512 MB pro zařízení s více než 1 GB paměti RAM, jinak je výchozí hodnota 32 MB.

Type: UInt32
Parameter Sets: (All)
Aliases:
Accepted values: 32, 64, 128, 256, 512

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

-SendToPreferredDistributionPoint

Pokud chcete povolit distribuci obsahu na vyžádání do upřednostňovaných distribučních bodů, nastavte tento parametr na $true. Když povolíte toto nastavení a klient požádá o obsah balíčku a obsah není k dispozici na žádných distribučních bodech, pak bod správy distribuuje obsah. Další informace najdete v tématu Distribuce obsahu na vyžádání.

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

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

-Version

Zadejte verzi spouštěcí image. Tato hodnota není verze operačního systému, ale řetězec, který spravujete.

Type: String
Parameter Sets: (All)
Aliases:

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

-WhatIf

Zobrazuje, co by se stalo při spuštění rutiny. Rutina se nespouštěl.

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

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

CommonParameters

Tato rutina podporuje společné parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction a -WarningVariable. Další informace najdete v tématu about_CommonParameters.

INPUTS

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

OUTPUTS

System.Object

POZNÁMKY

Get-CMBootImage

New-CMBootImage

Remove-CMBootImage

Get-CMWinPEOptionalComponentInfo

Správa spouštěcích imagí pomocí Správce konfigurace