Set-CMBootImage
SYNOPSIS
Een opstartafbeelding van het besturingssysteem wijzigen.
SYNTAX
SetByValueMandatory (standaard)
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
Gebruik deze cmdlet om een opstartafbeelding van het besturingssysteem te wijzigen. Opstartinstallatieprogramma's Windows pe-installatieprogramma's (Preinstallation Environment Windows) waarin u een clientcomputer opstart voordat u een besturingssysteem installeert.
U kunt apparaat stuurprogramma's toevoegen aan een opstartafbeelding of de eigenschappen ervan wijzigen. Voordat u een nieuw apparaat stuurprogramma kunt toevoegen, moet u eerst het stuurprogramma importeren in de Configuration Manager stuurprogrammacatalogus en inschakelen.
Elke versie van Configuration Manager ondersteunt een specifieke versie van de Windows Assessment and Deployment Kit (Windows ADK). U kunt opstartafbeeldingen leveren of aanpassen wanneer ze zijn gebaseerd op een Windows PE-versie van de ondersteunde versie van Windows ADK.
Zie Opstartafbeeldingen beheren met Configuration Manager voor meer Configuration Manager.
Notitie
Voer Configuration Manager cmdlets uit vanaf Configuration Manager-sitestation, bijvoorbeeld PS XYZ:\> . Zie Aan de slag voor meer informatie.
EXAMPLES
Voorbeeld 1: De naam van een opstartafbeelding wijzigen
Met deze opdracht haalt u een opstartafbeelding op basis van de pakket-id op en wijzigt u de naam ervan.
Set-CMBootimage -Id "CM100004" -NewName "Custom boot image"
Voorbeeld 2: Beschrijvende eigenschappen instellen
Met deze opdracht haalt u een opstartafbeelding op met de naam en voegt u er vervolgens een versie en beschrijving aan toe.
Set-CMBootImage -Name "Custom boot image (x64)" -Version "Contoso v2.1" -Description "Managed by jqpublic"
Voorbeeld 3: de toetsenbordindeling instellen
In het volgende voorbeeld wordt de standaard toetsenbordindeling van de opstartafbeelding ingesteld op de taal Russisch (Rusland). Hiermee wordt de opstartafbeelding geïdentificeerd op de id.
Set-CMBootimage -Id "CM100004" -InputLocale "ru-ru"
Voorbeeld 4: Optionele onderdelen toevoegen
In dit voorbeeld worden de optionele onderdelen van .NET en PowerShell op basis van deze onderdelen aan de opstartafbeelding toegevoegd.
$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
Geef een matrix van optionele onderdeelobjecten op die u wilt toevoegen aan de opstartinstallatie afbeelding. Gebruik de cmdlet Get-CMWinPEOptionalComponentInfo om dit object op te halen.
De volgende onderdelen worden vaak gebruikt:
- Microsoft .NET (WinPE-NetFX): Dit onderdeel is een vereiste voor PowerShell. Het is een van de grotere optionele onderdelen.
- Windows PowerShell (WinPE-PowerShell): dit onderdeel vereist .NET en voegt beperkte PowerShell-ondersteuning toe. Als u aangepaste PowerShell-scripts gebruikt tijdens de WinPE-fase van uw takenreeks, voegt u dit onderdeel toe. Er zijn mogelijk andere onderdelen vereist voor andere PowerShell-cmdlets.
- HTML (WinPE-HTA): als u aangepaste HTML-toepassingen tijdens de WinPE-fase van uw takenreeks hebt uitgevoerd, voegt u dit onderdeel toe.
Zie Opstartafbeeldingen beheren - optionele onderdelen voor meer informatie.
Type: IResultObject[]
Parameter Sets: (All)
Aliases: AddOptionalComponents
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-BackgroundBitmapPath
Geef het netwerkbestandspad op van een aangepast achtergrondafbeeldingsbestand dat moet worden gebruikt in Windows PE.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Confirm
Hiermee wordt u gevraagd om bevestiging voordat u de cmdlet uitvoert.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: cf
Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
-CopyToPackageShareOnDistributionPoint
Clients kunnen altijd een opstartafbeelding downloaden van een distributiepunt. Als u deze parameter in $true, maakt de site deze beschikbaar via een benoemde netwerk share op distributiepunten. Gebruik CustomPackageShareName om een aangepaste sharenaam op te geven.
Wanneer u deze optie inschakelen, is meer ruimte vereist op distributiepunten. Het is van toepassing op alle distributiepunten waarop u deze opstartafbeelding distribueert.
Type: Boolean
Parameter Sets: (All)
Aliases: CopyToPackageShareOnDistributionPoints
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-CustomPackageShareName
Als u CopyToPackageShareOnDistributionPoint inschakelen, kunt u deze parameter gebruiken om de sharenaam aan te passen. De maximale lengte is 127 tekens en mag geen van de volgende tekens bevatten: " / [ ] : | < > + = ; , ? * . U kunt een sharenaam en mapnaam opgeven, maar het maximum voor elk bestand is 80 tekens. Bijvoorbeeld ShareName\FolderName.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DeployFromPxeDistributionPoint
Stel deze parameter in op $true deze opstartafbeelding beschikbaar te maken vanaf een distributiepunt met PXE-functie. Zie PXEgebruiken voor het implementeren van Windows via het netwerk voor meer informatie.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Beschrijving
Geef een optionele beschrijving van een opstartafbeelding op om u te helpen deze te identificeren.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DisableWildcardHandling
Deze parameter behandelt jokertekens als letterlijke tekenwaarden. U kunt deze niet combineren met ForceWildcardHandling.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DisconnectUserFromDistributionPoint
Deze optie is afgeschaft. Hiermee stelt u de eigenschap ForcedDisconnectEnabled van de opstartafbeelding in.
Type: Boolean
Parameter Sets: (All)
Aliases: DisconnectUsersFromDistributionPoints
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DisconnectUserFromDistributionPointMins
Deze optie is afgeschaft. Hiermee stelt u de eigenschap ForcedDisconnectDelay van de opstartafbeelding in.
Type: UInt32
Parameter Sets: (All)
Aliases: DisconnectUsersFromDistributionPointsMinutes
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DisconnectUserFromDistributionPointRetryCount
Deze optie is afgeschaft. Hiermee stelt u de eigenschap ForcedDisconnectNumRetries van de opstartafbeelding in.
Type: UInt32
Parameter Sets: (All)
Aliases: DisconnectUsersFromDistributionPointsRetries
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DistributionPointUpdateSchedule
Gebruik deze parameter om distributiepunten volgens een schema bij te werken. Gebruik de cmdlet New-CMSchedule om een schemaobject op te halen.
Type: IResultObject
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-EnableBinaryDeltaReplication
Stel deze parameter in op $true binaire differentiële replicatie (BDR) in teschakelen. Zie Basisconcepten voor inhoudsbeheer inConfiguration Manager.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-EnableCommandSupport
Alleen in niet-productieomgevingen kunt u deze parameter instellen op $true opdrachtondersteuning in te stellen. Wanneer een apparaat wordt op start naar deze afbeelding, kunt u op F8 drukken om een opdrachtprompt voor beheer te openen. Deze optie is handig voor het oplossen van problemen tijdens het testen van uw implementatie. Het gebruik van deze instelling in een productie-implementatie wordt niet aanbevolen vanwege beveiligingsproblemen.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-EnablePrestartCommand
Stel deze parameter in op $true om een prestart-opdracht in te stellen. Deze opdrachtregel wordt uitgevoerd voordat de takenreeks wordt gestart.
Configureer ook de volgende parameters: 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
Voer de opdracht uit zonder om bevestiging te vragen.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ForceWildcardHandling
Deze parameter verwerkt jokertekens en kan leiden tot onverwacht gedrag (niet aanbevolen). U kunt deze niet combineren met DisableWildcardHandling.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Id
Geef een opstartafbeeldings-id op die u wilt configureren. Deze waarde is een standaard pakket-id, bijvoorbeeld: XYZ00002 .
Type: String
Parameter Sets: SetById
Aliases: PackageId
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-IncludeFilesForPrestart
Als u EnablePrestartCommand inschakelen, gebruikt u deze parameter als voor de prestart-opdracht andere bestanden moeten worden uitgevoerd. Gebruik vervolgens de parameter PrestartIncludeFilesDirectory om de locatie op te geven van de bestanden die moeten worden opgeslagen.
Als u bijvoorbeeld een batchscript wilt uitvoeren, gebruikt u deze optie om het scriptbestand op te nemen.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-InputLocale
Gebruik deze parameter om de standaard toetsenbordindeling voor een opstartafbeelding te configureren. Geef de taaltag op. Geef bijvoorbeeld de tekenreeks op om de invoer landinvoer in te stellen op Russisch ru-ru (Rusland). Zie [MS-LCID]: Windows Language Code Identifier (LCID)-verwijzing voor meer informatie.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-InputObject
Geef een opstartafbeeldingsobject op dat moet worden geconfigureerd. Gebruik de cmdlet Get-CMBootImage om dit object op te halen.
Type: IResultObject
Parameter Sets: SetByValueMandatory
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False
-Name
Geef de naam op van een opstartafbeelding die u wilt configureren.
Type: String
Parameter Sets: SetByName
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-NewName
Geef een nieuwe naam op voor de opstartafbeelding.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-PassThru
Voeg deze parameter toe om een object te retourneren dat het item vertegenwoordigt waarmee u werkt. Standaard is het mogelijk dat deze cmdlet geen uitvoer genereert.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Path
Geef het netwerkpad op van de Windows PE-afbeelding die door deze opstartafbeelding wordt gebruikt. U kunt het pad voor standaard opstartafbeeldingen niet wijzigen.
Type: String
Parameter Sets: (All)
Aliases: ImagePath
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-PersistContentInCache
Als u niet wilt dat de inhoud van dit pakket uit de clientcache wordt verwijderd om ruimte te maken voor andere inhoud, stelt u deze parameter in op $true deze in de clientcache te houden.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-PrestageBehavior
Geef het gedrag op wanneer u een distributiepunt inschakelen voor voorgefaseerd inhoud:
ManualCopy: Kopieer de inhoud in dit pakket handmatig naar het distributiepuntDownloadDelta: Alleen inhoudswijzigingen downloaden naar het distributiepuntOnDemand: inhoud automatisch downloaden wanneer pakketten worden toegewezen aan distributiepunten
Zie Voorgefaseerd inhoud gebruiken voor meer informatie.
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
Als u EnablePrestartCommand inschakelen, gebruikt u deze parameter om op te geven van de opdrachtregel uit te voeren. De maximale lengte is 4096 tekens.
Als de opdrachtregel bestanden vereist die zich niet in Windows PE, gebruikt u de parameters IncludeFilesForPrestart en PrestartIncludeFilesDirectory.
Type: String
Parameter Sets: (All)
Aliases: CommandLine
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-PrestartIncludeFilesDirectory
Als u EnablePrestartCommand en IncludeFilesForPrestart inschakelen, gebruikt u deze parameter om het netwerkpad op te geven van de bestanden die moeten worden opgeslagen in de opstartafbeelding.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Prioriteit
Geef de volgorde op waarin de site de inhoud naar andere sites en de distributiepunten op deze site verzendt.
De site verzendt inhoud met hoge prioriteit vóór pakketten met een gemiddelde of lage prioriteit. Pakketten met gelijke prioriteit worden verzonden in de volgorde waarin ze worden gemaakt.
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
-Opnieuw laden
Is van toepassing op versie 2006 en hoger. Als de versies van de Windows ADK-onderdelen in de opstartafbeelding verouderd zijn, voegt u deze parameter toe om de opstartafbeelding opnieuw te laden met de huidige Windows PE-versie van de Windows ADK. Zie Update distribution points with the boot image (Distributiepunten bijwerken met de opstartafbeelding) voor meer informatie.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: ReloadImage
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-RemoveOptionalComponent
Geef een matrix van optionele onderdeelobjecten op die u wilt verwijderen uit de opstartinstallatie afbeelding. Gebruik de cmdlet Get-CMWinPEOptionalComponentInfo om dit object op te halen.
Verwijder niet de volgende onderdelen, die vereist zijn voor Configuration Manager:
- Scripting (WinPE-Scripting)
- Opstarten (WinPE-SecureStartup)
- Netwerk (WinPE-WDS-Tools)
- Scripting (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
Configureer de Windows PE-scratchruimte, die door Windows PE wordt gebruikt als tijdelijke opslag (RAM-station). Wanneer er bijvoorbeeld een toepassing wordt uitgevoerd in WinPE en er tijdelijke bestanden moet worden geschreven, stuurt WindPE de bestanden naar de scratchruimte in het geheugen om de aanwezigheid van een harde schijf te simuleren. Dit is standaard 512 MB voor apparaten met meer dan 1 GB RAM, anders is de standaardwaarde 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
Als u inhoudsdistributie op aanvraag naar voorkeursdistributiepunten wilt inschakelen, stelt u deze parameter in op $true. Wanneer u deze instelling inschakelen, als een client de inhoud voor het pakket aanvraagt en de inhoud niet beschikbaar is op distributiepunten, distribueert het beheerpunt de inhoud. Zie Inhoudsdistributie op aanvraag voor meer informatie.
Type: Boolean
Parameter Sets: (All)
Aliases: SendToPreferredDistributionPoints
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Versie
Geef de versie van de opstartafbeelding op. Deze waarde is niet de versie van het besturingssysteem, maar een tekenreeks die u beheert.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-WhatIf
Hiermee wordt weergegeven wat er zou gebeuren als u de cmdlet uitvoert. De cmdlet wordt niet uitgevoerd.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: wi
Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
CommonParameters
Deze cmdlet biedt ondersteuning voor de meest gebruikte parameters: -Debug, - ErrorAction, - ErrorVariable, - InformationAction, -InformationVariable, - OutVariable,-OutBuffer, - PipelineVariable - Verbose, - WarningAction en -WarningVariable. Zie voor meer informatie about_CommonParameters.