Set-CMBootImage
SYNOPSIS
Operációs rendszer rendszerindító lemezképének módosítása.
SYNTAX
SetByValueMandatory (alapértelmezett)
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 (Készletazonosító)
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 (Beállítási név)
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
Ezzel a parancsmag használatával módosíthatja az operációs rendszer rendszerindító lemezképét. A rendszerindító lemezképek Windows környezet (Windows PE) rendszerképeit, amelyekbe az operációs rendszer telepítése előtt elindítja az ügyfélszámítógépet.
Hozzáadhat eszközillesztőket a rendszerindító lemezképhez, vagy módosíthatja a tulajdonságait. Új eszközillesztő hozzáadásához először importálni kell az illesztőprogramot a Konfigurációkezelő katalógusba, és engedélyezni kell.
A Konfigurációkezelő egyes verziói a Windows Assessment and Deployment Kit (Windows ADK) adott verzióját támogatják. A rendszerindító lemezképeket akkor szervizelheti vagy szabhatja testre, ha azok az ADK támogatott Windows PE-verzióján Windows alapulnak.
További információ: Rendszerindító lemezképek kezelése a Konfigurációkezelő.
Megjegyzés
Futtassa Konfigurációkezelő parancsmagokat a Konfigurációkezelő hely meghajtóról, például: PS XYZ:\> . További információ: Első lépések.
EXAMPLES
1. példa: Rendszerindító lemezkép átnevezése
Ez a parancs lekért egy rendszerindító lemezképet a csomagazonosítója alapján, majd átnevezi.
Set-CMBootimage -Id "CM100004" -NewName "Custom boot image"
2. példa: Leíró tulajdonságok beállítása
Ez a parancs lekért egy rendszerindító lemezképet a neve alapján, majd hozzáad egy verziót és egy leírást.
Set-CMBootImage -Name "Custom boot image (x64)" -Version "Contoso v2.1" -Description "Managed by jqpublic"
3. példa: A billentyűzetkiosztás beállítása
Az alábbi példa a rendszerindító lemezkép alapértelmezett billentyűzetkiosztását az orosz (orosz) nyelvre állítja be. Azonosító alapján azonosítja a rendszerindító lemezképet.
Set-CMBootimage -Id "CM100004" -InputLocale "ru-ru"
4. példa: Választható összetevők hozzáadása
Ez a példa lekérte a választható .NET- és PowerShell-összetevőket, majd hozzáadja őket a rendszerindító lemezképhez.
$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
Adja meg a rendszerindító lemezképhez hozzáadni kívánt választható összetevőobjektumok tömbjét. Az objektum leállításához használja a Get-CMWinPEOptionalComponentInfo parancsmagot.
Általában a következő összetevőket használják:
- Microsoft .NET (WinPE-NetFX): Ez az összetevő a PowerShell előfeltétele. Ez az egyik nagyobb választható összetevő.
- Windows PowerShell (WinPE-PowerShell): Ehhez az összetevőhez .NET-re van szükség, és korlátozott PowerShell-támogatást igényel. Ha egyéni PowerShell-parancsfájlokat futtat a feladatütemezés WinPE fázisában, adja hozzá ezt az összetevőt. Más PowerShell-parancsmagok esetén más összetevőkre is szükség lehet.
- HTML (WinPE-HTA): Ha egyéni HTML-alkalmazásokat futtat a feladatütemezés WinPE szakaszában, adja hozzá ezt az összetevőt.
További információ: Rendszerindító lemezképek kezelése – választható összetevők.
Type: IResultObject[]
Parameter Sets: (All)
Aliases: AddOptionalComponents
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-BackgroundBitmapPath
Adja meg a pe-fájlban használni kívánt egyéni háttérképfájl hálózati Windows elérési útját.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Confirm
Jóváhagyást kér a parancsmag futtatása előtt.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: cf
Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
-CopyToPackageShareOnDistributionPoint
Az ügyfelek mindig letölthetik a rendszerindító lemezképet egy terjesztési pontról. Ha ezt a paramétert a $true, a hely egy elnevezett hálózati megosztáson keresztül teszi elérhetővé a terjesztési pontokon. Egyéni megosztás nevének megadásához használja a CustomPackageShareName nevet.
Ha engedélyezi ezt a beállítást, több helyre van szükség a terjesztési pontokon. Minden olyan terjesztési pontra vonatkozik, amelyre a rendszerindító lemezképet terjeszti.
Type: Boolean
Parameter Sets: (All)
Aliases: CopyToPackageShareOnDistributionPoints
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-CustomPackageShareName
Ha engedélyezi a CopyToPackageShareOnDistributionPointot, ezzel a paraméterrel testre szabhatja a megosztás nevét. A maximális hossz 127 karakter, és nem tartalmazhatja a következő karakterek egyikét sem: " / [ ] : | < > + = ; , ? * . Megadhatja a megosztás és a mappa nevét, de a maximális érték 80 karakter lehet. Például: ShareName\FolderName.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DeployFromPxeDistributionPoint
Állítsa ezt a paramétert $true értékre, hogy a rendszerindító lemezkép elérhető legyen egy PXE-képes terjesztési pontról. További információ: PXE használata Windows hálózaton keresztüli központi telepítéséhez.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Description (Leírás)
Ha szükséges, adja meg a rendszerindító lemezkép leírását, amely segít azonosítani.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DisableWildcardHandling
Ez a paraméter literál karakterértékekként kezeli a helyettesítő karaktereket. Nem kombinálhatja a ForceWildcardHandling használatával.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DisconnectUserFromDistributionPoint
Ez a beállítás elavult. Beállítja a rendszerindító lemezkép ForcedDisconnectEnabled tulajdonságát.
Type: Boolean
Parameter Sets: (All)
Aliases: DisconnectUsersFromDistributionPoints
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DisconnectUserFromDistributionPointMins
Ez a beállítás elavult. Beállítja a rendszerindító lemezkép ForcedDisconnectDelay tulajdonságát.
Type: UInt32
Parameter Sets: (All)
Aliases: DisconnectUsersFromDistributionPointsMinutes
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DisconnectUserFromDistributionPointRetryCount
Ez a beállítás elavult. Beállítja a rendszerindító lemezkép ForcedDisconnectNumRetries tulajdonságát.
Type: UInt32
Parameter Sets: (All)
Aliases: DisconnectUsersFromDistributionPointsRetries
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DistributionPointUpdateSchedule
Ezzel a paraméterrel ütemezetten frissítheti a terjesztési pontokat. Egy schedule objektum lekért használhatja a New-CMSchedule parancsmagot.
Type: IResultObject
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-EnableBinaryDeltaReplication
A bináris különbözeti replikáció (BDR$true engedélyezéséhez állítsa be ezt a paramétert. További információ: A tartalomkezelés alapvető fogalmai a Konfigurációkezelő.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-EnableCommandSupport
Nem éles környezetben, csak tesztkörnyezetekben beállíthatja ezt a paramétert $true a parancstámogatás engedélyezéséhez. Amikor egy eszköz elindul ezen a rendszerképen, az F8 billentyű lenyomása után megnyithat egy rendszergazdai parancssort. Ez a lehetőség az üzembe helyezés tesztelése közbeni hibaelhárításhoz hasznos. Ez a beállítás éles környezetben való használata biztonsági okokból nem javasolt.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-EnablePrestartCommand
Ezt a paramétert állítsa $true az indítás előtti parancs engedélyezéséhez. Ez a parancssor a feladatütemezés indítása előtt fut le.
Emellett konfigurálja a következő paramétereket is: 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
Futtassa a parancsot a megerősítés kérése nélkül.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ForceWildcardHandling
Ez a paraméter feldolgozza a helyettesítő karaktereket, és váratlan viselkedéshez vezethet (nem ajánlott). Nem kombinálhatja a DisableWildcardHandling kártyával.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Id (Azonosító)
Adja meg a konfigurálni kívánt rendszerindító lemezkép azonosítóját. Ez az érték egy standard csomagazonosító, például: XYZ00002 .
Type: String
Parameter Sets: SetById
Aliases: PackageId
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-IncludeFilesForPrestart
Ha engedélyezi az EnablePrestartCommand parancsot, használja ezt a paramétert, ha az indítás előtti parancs más fájlok futtatását igényli. Ezután a PrestartIncludeFilesDirectory paraméterrel adja meg a tartalmazni kívánt fájlok helyét.
Ha például kötegelt szkriptet szeretne futtatni, ezzel a beállítással adhatja meg a parancsfájlt.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-InputLocale
Ezzel a paraméterrel konfigurálhatja egy rendszerindító lemezkép alapértelmezett billentyűzetkiosztását. Adja meg a nyelvcímkét. Ha például a bemeneti területi beállításokat Orosz (Oroszország) beállításra van beállítva, adja meg a ru-ru sztringet. További információ: [MS-LCID]: Windows Language Code Identifier (LCID) Reference (Nyelvi kódazonosító (LCID) referenciája).
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-InputObject
Adja meg a konfigurálni kívánt rendszerindító lemezképobjektumot. Az objektum lekért használhatja a Get-CMBootImage parancsmagot.
Type: IResultObject
Parameter Sets: SetByValueMandatory
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False
-Name
Adja meg a konfigurálni kívánt rendszerindító lemezkép nevét.
Type: String
Parameter Sets: SetByName
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-NewName (Új név)
Adjon meg egy új nevet a rendszerindító lemezképnek.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-PassThru
Adja hozzá ezt a paramétert, hogy egy objektumot adjon vissza, amely azt az elemet jelöli, amellyel dolgozik. Alapértelmezés szerint ez a parancsmag nem generál kimenetet.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Path
Adja meg a rendszerindító lemezkép által használt Windows PE-lemezkép hálózati elérési útját. Az alapértelmezett rendszerindító lemezképek elérési útja nem változtatható meg.
Type: String
Parameter Sets: (All)
Aliases: ImagePath
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-PersistContentInCache
Ha nem szeretné, hogy a csomag tartalma elavadjön az ügyfélgyorsítótárból, hogy helyet adva legyen más tartalmaknak, állítsa $true paraméterre, hogy az ügyfélgyorsítótárban is megmarad.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-PrestageBehavior
Adja meg a viselkedést, amikor engedélyezi a terjesztési pontot az előtagként megadott tartalomhoz:
ManualCopy: A csomag tartalmának manuális másolása a terjesztési pontraDownloadDelta: Csak a terjesztési pont tartalomváltozásának letöltéseOnDemand: Tartalom automatikus letöltése, ha a csomagok hozzá vannak rendelve a terjesztési pontokhoz
További információ: Use prestaged content ..
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
Ha engedélyezi az EnablePrestartCommand parancsot, ezzel a paraméterrel adhatja meg a futtatni kívánt parancssort. A maximális hossz 4096 karakter.
Ha a parancssorhoz olyan fájlokra van szükség, amelyek nem a Windows PE-hez tartoznak, használja az IncludeFilesForPrestart és a PrestartIncludeFilesDirectory paramétereket.
Type: String
Parameter Sets: (All)
Aliases: CommandLine
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-PrestartIncludeFilesDirectory
Ha engedélyezi az EnablePrestartCommand és az IncludeFilesForPrestart paramétert, ezzel a paraméterrel adhatja meg a rendszerindító lemezképbe foglalni kívánt fájlok hálózati elérési útját.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Priority (Prioritás)
Adja meg, hogy a hely milyen sorrendben küldi el a tartalmat a hely más helyeinek és terjesztési pontjainak.
A hely magas prioritású tartalmat küld a közepes vagy alacsony prioritású csomagok előtt. Az azonos prioritású csomagok a létrehozásuk sorrendjében vannak elküldve.
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 (Újratöltés)
A 2006-os és újabb verziókra vonatkozik. Ha a Windows ADK összetevőinek verziója elavult a rendszerindító lemezképben, adja hozzá ezt a paramétert, hogy újra betöltse a rendszerindító lemezképet az aktuális Windows PE-verzióval az Windows ADK-ból. További információ: Terjesztési pontok frissítése a rendszerindító lemezképpel.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: ReloadImage
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-RemoveOptionalComponent
Adja meg a rendszerindító lemezképből eltávolítandó választható összetevő-objektumok tömbjét. Az objektum leállításához használja a Get-CMWinPEOptionalComponentInfo parancsmagot.
Ne távolítsa el a következő összetevőket, amelyekre a Konfigurációkezelő:
- Parancsprogramozás (WinPE-Scripting)
- Indítás (WinPE-SecureStartup)
- Hálózat (WinPE-WDS-Tools)
- Parancsprogramozás (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
Konfigurálja a Windows PE ideiglenes területet, amely a WinPE által használt ideiglenes tárhely (RAM-meghajtó). Például amikor egy alkalmazás fut a WinPE környezetben, és ideiglenes fájlok írására van szüksége, a WinPE egy merevlemez jelenlétének szimulálásához átirányítja ezeket a fájlokat a memóriában található ideiglenes területre. Ez a mennyiség alapértelmezés szerint 512 MB a több mint 1 GB RAM-mal rendelkező eszközök esetén, ellenkező esetben az alapértelmezett érték 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
Ha engedélyezni szeretné az igény szerinti tartalomterjesztést az előnyben részesített terjesztési pontokra, állítsa ezt a paramétert a következőre: $true. Ha engedélyezi ezt a beállítást, és egy ügyfél a csomag tartalmát kéri le, és a tartalom egyetlen terjesztési ponton sem érhető el, akkor a felügyeleti pont terjeszti a tartalmat. További információ: Igény szerinti tartalomterjesztés.
Type: Boolean
Parameter Sets: (All)
Aliases: SendToPreferredDistributionPoints
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Version (Verzió)
Adja meg a rendszerindító lemezkép verzióját. Ez az érték nem az operációs rendszer verziója, hanem egy Ön által megadott sztring.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-WhatIf
Bemutatja, mi történne a parancsmag futtatásakor. A parancsmag nem fut.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: wi
Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
CommonParameters
Ez a parancsmag a következő általános paramétereket támogatja: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction és -WarningVariable. További információ: about_CommonParameters.