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 boduOnDemand: 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.