Megosztás a következőn keresztül:


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 pontra
  • DownloadDelta: Csak a terjesztési pont tartalomváltozásának letöltése
  • OnDemand: 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.

INPUTS

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

OUTPUTS

System.Object

MEGJEGYZÉSEK

Get-CMBootImage

New-CMBootImage

Remove-CMBootImage

Get-CMWinPEOptionalComponentInfo

Rendszerindító lemezképek kezelése a Konfigurációkezelő