Set-CMBootImage

Artikel
08/12/2021

SYNOPSIS

Ändra en startavbildning för operativsystemet.

SYNTAX

SetByValueMandatory (standard)

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

Använd den här cmdleten för att ändra en startavbildning av operativsystemet. Startavbildningar är Windows preinstallation Environment (Windows PE)-avbildningar där du startar en klientdator innan du installerar ett operativsystem.

Du kan lägga till enhetsdrivrutiner i en startavbildning eller ändra dess egenskaper. Innan du kan lägga till en ny enhetsdrivrutin måste du först importera drivrutinen till Konfigurationshanteraren och aktivera den.

Varje version av Konfigurationshanteraren stöder en specifik version av Windows Assessment and Deployment Kit (Windows ADK). Du kan använda eller anpassa startavbildningar när de baseras på en Windows PE-version från den version av ADK Windows stöds.

Mer information finns i Hantera startavbildningar med Konfigurationshanteraren.

Anteckning

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

EXAMPLES

Exempel 1: Byt namn på en startavbildning

Det här kommandot hämtar en startavbildning efter dess paket-ID och byter sedan namn på den.

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

Exempel 2: Ange beskrivande egenskaper

Det här kommandot hämtar en startavbildning med dess namn och lägger sedan till en version och beskrivning i den.

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

Exempel 3: Ange tangentbordslayout

I följande exempel anges standardtangentbordslayouten för startbilden till det ryska språket (Ryssland). Den identifierar startavbildningen med dess ID.

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

Exempel 4: Lägga till valfria komponenter

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

$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

Ange en matris med valfria komponentobjekt som ska läggas till i startavbildningen. Hämta det här objektet med cmdleten Get-CMWinPEOptionalComponentInfo.

Följande komponenter används ofta:

Microsoft .NET (WinPE-NetFX): Den här komponenten är en förutsättning för PowerShell. Det är en av de större valfria komponenterna.
Windows PowerShell (WinPE-PowerShell): Den här komponenten kräver .NET och lägger till begränsat PowerShell-stöd. Om du kör anpassade PowerShell-skript under WinPE-fasen i aktivitetssekvensen lägger du till den här komponenten. Det finns andra komponenter som kan krävas för andra PowerShell-cmdlets.
HTML (WinPE-HTA): Om du kör anpassade HTML-program under WinPE-fasen i aktivitetssekvensen lägger du till den här komponenten.

Mer information finns i Hantera startavbildningar – valfria komponenter.

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

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

-BackgroundBitmapPath

Ange sökvägen till nätverksfilen för en anpassad bakgrundsbildsfil som ska användas i Windows PE.

Type: String
Parameter Sets: (All)
Aliases:

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

-Confirm

Uppmanar dig att bekräfta innan du kör cmdleten.

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

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

-CopyToPackageShareOnDistributionPoint

Klienter kan alltid ladda ned en startavbildning från en distributionsplats. Om du anger den här parametern $true, gör platsen den tillgänglig via en namngiven nätverksresurs på distributionsplatser. Använd CustomPackageShareName för att ange ett anpassat resursnamn.

När du aktiverar det här alternativet krävs mer utrymme på distributionsplatser. Det gäller för alla distributionsplatser som du distribuerar den här startavbildningen till.

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

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

-CustomPackageShareName

Om du aktiverar CopyToPackageShareOnDistributionPoint kan du använda den här parametern för att anpassa resursnamnet. Den maximala längden är 127 tecken och får inte innehålla något av följande tecken: " / [ ] : | < > + = ; , ? * . Du kan ange ett resursnamn och ett mappnamn, men maxvärdet för var och en är 80 tecken. Till exempel ShareName\FolderName.

Type: String
Parameter Sets: (All)
Aliases:

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

-DeployFromPxeDistributionPoint

Ange den här parametern $true att göra den här startavbildningen tillgänglig från en PXE-aktiverad distributionsplats. Mer information finns i Använda PXE för att Windows över nätverket.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-Beskrivning

Ange en valfri beskrivning av en startavbildning som hjälper dig att identifiera den.

Type: String
Parameter Sets: (All)
Aliases:

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

-DisconnectUserFromDistributionPoint

Det här alternativet är inaktuellt. Den anger egenskapen ForcedDisconnectEnabled för startavbildningen.

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

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

-DisconnectUserFromDistributionPointMins

Det här alternativet är inaktuellt. Den anger egenskapen ForcedDisconnectDelay för startavbildningen.

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

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

-DisconnectUserFromDistributionPointRetryCount

Det här alternativet är inaktuellt. Den anger egenskapen ForcedDisconnectNumRetries för startavbildningen.

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

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

-DistributionPointUpdateSchedule

Använd den här parametern för att uppdatera distributionsplatser enligt ett schema. Om du vill hämta ett schemaobjekt använder du cmdleten New-CMSchedule.

Type: IResultObject
Parameter Sets: (All)
Aliases:

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

-EnableBinaryDeltaReplication

Ange den här parametern $true aktivera binär differentiell replikering (BDR). Mer information finns i Grundläggande begrepp för innehållshantering i Konfigurationshanteraren.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-EnableCommandSupport

I testmiljöer som inte är produktionsmiljöer kan du ange den här parametern till $true för att aktivera kommandostöd. När en enhet startar på den här avbildningen kan du trycka på F8 för att öppna en administrativ kommandotolk. Det här alternativet är användbart för felsökning när du testar distributionen. Vi rekommenderar inte att du använder den här inställningen i en produktionsdistribution av säkerhetsskäl.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-EnablePrestartCommand

Ange den här parametern till $true för att aktivera ett förinstartskommando. Den här kommandoraden körs innan aktivitetssekvensen startar.

Konfigurera även följande parametrar: 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

Kör kommandot utan att be om bekräftelse.

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

-Id

Ange ett startavbildnings-ID som ska konfigureras. Det här värdet är ett standardpaket-ID, till exempel: XYZ00002 .

Type: String
Parameter Sets: SetById
Aliases: PackageId

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

-IncludeFilesForPrestart

Om du aktiverar EnablePrestartCommand använder du den här parametern om förinstartskommandot kräver att andra filer körs. Använd sedan parametern PrestartIncludeFilesDirectory för att ange platsen för filerna som ska inkluderas.

Om du till exempel vill köra ett batchskript använder du det här alternativet för att inkludera skriptfilen.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-InputLocale

Använd den här parametern för att konfigurera standardtangentbordslayouten för en startavbildning. Ange språktaggen. Om du till exempel vill ställa in indata på ryska (Ryssland) anger du strängen ru-ru . Mer information finns i [MS-LCID]: Windows LCID-referens (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

Ange ett startavbildningsobjekt som ska konfigureras. Hämta det här objektet med cmdleten 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

Ange namnet på en startavbildning som ska konfigureras.

Type: String
Parameter Sets: SetByName
Aliases:

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

-NewName

Ange ett nytt namn för startavbildningen.

Type: String
Parameter Sets: (All)
Aliases:

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

-PassThru

Lägg till den här parametern för att returnera ett objekt som representerar det objekt som du arbetar med. Som standard genererar den här cmdleten kanske inte några utdata.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-Path

Ange nätverkssökvägen för den Windows PE-avbildningen som den här startavbildningen använder. Du kan inte ändra sökvägen för standardstartavbildningar.

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

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

-PersistContentInCache

Om du inte vill att innehållet i det här paketet ska bli äldre än klientcachen för att göra plats för annat innehåll anger du den här parametern till $true att spara den i klientcachen.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-PrestageBehavior

Ange beteendet när du aktiverar en distributionsplats för förinstallerat innehåll:

ManualCopy: Kopiera innehållet i det här paketet manuellt till distributionsplatsen
DownloadDelta: Hämta endast innehållsändringar till distributionsplatsen
OnDemand: Hämta innehåll automatiskt när paket tilldelas till distributionsplatser

Mer information finns i Använda förinstallerat innehåll.

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

Om du aktiverar EnablePrestartCommand använder du den här parametern för att ange vilken kommandorad som ska köras. Den maximala längden är 4 096 tecken.

Om kommandoraden kräver filer som inte finns i Windows PE använder du parametrarna IncludeFilesForPrestart och PrestartIncludeFilesDirectory.

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

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

-PrestartIncludeFilesDirectory

Om du aktiverar EnablePrestartCommand och IncludeFilesForPrestart använder du den här parametern för att ange nätverkssökvägen för de filer som ska ingå i startavbildningen.

Type: String
Parameter Sets: (All)
Aliases:

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

-Prioritet

Ange i vilken ordning webbplatsen skickar innehållet till andra platser och distributionsplatserna på den här platsen.

Webbplatsen skickar innehåll med hög prioritet före paket med medelhög eller låg prioritet. Paket med samma prioritet skickas i den ordning som de skapas.

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

Gäller för version 2006 och senare. Om versionerna av adk Windows komponenterna i startavbildningen är in date-in date lägger du till den här parametern för att läsa in startavbildningen med den aktuella Windows PE-versionen från Windows ADK. Mer information finns i Uppdatera distributionsplatser med startavbildningen.

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

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

-RemoveOptionalComponent

Ange en matris med valfria komponentobjekt som ska tas bort från startavbildningen. Hämta det här objektet med cmdleten Get-CMWinPEOptionalComponentInfo.

Ta inte bort följande komponenter, som krävs av Konfigurationshanteraren:

Skriptning (WinPE-Skript)
Start (WinPE-SecureStartup)
Nätverk (WinPE-WDS-Tools)
Skriptning (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

Konfigurera det tillfälliga utrymmet för Windows PE, som är ett tillfälligt lagringsutrymme (RAM-enhet) som används av WinPE. När t.ex. ett program körs inom WinPE och behöver skriva tillfälliga filer dirigerar WinPE om filerna till det tillfälliga utrymmet i minnet för att simulera närvaron av en hårddisk. Som standard är den här mängden 512 MB för enheter med mer än 1 GB RAM-minne, annars är standardvärdet 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

Om du vill aktivera innehållsdistribution på begäran till prioriterade distributionsplatser anger du den här parametern till $true. När du aktiverar den här inställningen, om en klient begär innehållet för paketet och innehållet inte är tillgängligt på några distributionsplatser, distribuerar hanteringsplatsen innehållet. Mer information finns i Innehållsdistribution på begäran.

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

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

-Version

Ange versionen av startavbildningen. Det här värdet är inte operativsystemversionen, utan en sträng som du hanterar.

Type: String
Parameter Sets: (All)
Aliases:

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

-WhatIf

Visar vad som skulle hända om cmdleten kördes. Cmdleten körs inte.

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

Required: False
Position: Named
Default value: False
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

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

OUTPUTS

System.Object

ANTECKNINGAR

Get-CMBootImage

New-CMBootImage

Remove-CMBootImage

Get-CMWinPEOptionalComponentInfo

Hantera startavbildningar med Konfigurationshanteraren

Dela via