New-CMBootableMedia
SYNOPSIS
Opstartbare media maken.
SYNTAX
New-CMBootableMedia [-AllowUacPrompt] [-AllowUnattended] [-AllowUnknownMachine] -BootImage <IResultObject>
[-CertificateExpireTime <DateTime>] [-CertificatePassword <SecureString>] [-CertificatePath <String>]
[-CertificateStartTime <DateTime>] -DistributionPoint <IResultObject[]> [-Force] [-FormatMedia]
-ManagementPoint <IResultObject[]> [-SiteCode <String>] -MediaMode <MediaMode> [-MediaPassword <SecureString>]
-MediaType <MediaInputType> [-NoAutoRun] -Path <String> [-PrestartCommand <String>]
[-PrestartPackage <IResultObject>] [-TemporaryFolder <String>] [-UserDeviceAffinity <UserDeviceAffinityType>]
[-Variable <Hashtable>] [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm]
[<CommonParameters>]
DESCRIPTION
Met deze cmdlet maakt u media die worden gebruikt om een besturingssysteem te implementeren. Opstartbare media bevatten de opstartafbeelding, optionele prestart-opdrachten en bijbehorende bestanden en Configuration Manager bestanden. Gebruik opstartbare media om een nieuwe versie van Windows installeren op een nieuwe computer (bare-metal) of om een bestaande computer te vervangen en instellingen over te dragen.
Notitie
Voor deze cmdlet zijn verhoogde machtigingen vereist om uit te voeren.
Zie Overzicht van takenreeksmedia voor meer informatie.
Notitie
Voer Configuration Manager cmdlets uit vanaf Configuration Manager sitestation, bijvoorbeeld PS XYZ:\> . Zie Aan de slag voor meer informatie.
EXAMPLES
Voorbeeld 1: Opstartbare media maken
De eerste opdracht haalt het opstartafbeeldingsobject met de naam Opstartafbeelding (x64) op en slaat deze op in de $BootImage variabele. Met de tweede opdracht wordt de distributiepuntrol voor SiteServer01.Contoso.com en op de $DistributionPoint op slaat. Met de derde opdracht wordt de beheerpuntrol voor SiteServer02.Contoso.com en op de $ManagementPoint op te nemen. Met de laatste opdracht maakt u opstartbare media in de dynamische modus. Hierbij worden de objecten gebruikt die zijn opgeslagen in de vorige variabelen.
$BootImage = Get-CMBootImage -Name "Boot image (x64)"
$DistributionPoint = Get-CMDistributionPoint -SiteCode CM1
$ManagementPoint = Get-CMManagementPoint -SiteSystemServerName "SiteSystemServer02.Contoso.com"
New-CMBootableMedia -MediaMode Dynamic -MediaType CdDvd -Path "\\Server\share\test.iso" -AllowUnknownMachine -BootImage $BootImage -DistributionPoint $DistributionPoint -ManagementPoint $ManagementPoint
PARAMETERS
-AllowUacPrompt
Voeg deze parameter toe zodat Windows u kunt vragen om uw beheerdersmachtigingen uit te verhogen met Gebruikersaccountbeheer (UAC). Voor deze cmdlet zijn verhoogde machtigingen vereist om uit te voeren.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-AllowUnattended
Voeg deze parameter toe om een implementatie van het besturingssysteem zonder toezicht toe te staan. Een implementatie van een besturingssysteem zonder toezicht vraagt niet om netwerkconfiguratie of optionele takenreeksen.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-AllowUnknownMachine
Voeg deze parameter toe om toe te Configuration Manager om onbekende computers in terichten. Een onbekende computer is een computer die de site nog niet heeft ontdekt.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-BootImage
Geef een opstartafbeeldingsobject op. Gebruik de cmdlet Get-CMBootImage om dit object op te halen.
Type: IResultObject
Parameter Sets: (All)
Aliases: BootImagePackage
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-CertificateExpireTime
Als u een zelf-ondertekend mediacertificaat voor HTTP-communicatie maakt, geeft deze parameter de vervaldatum en -tijd van het certificaat op. Geef in de toekomst voldoende datum/tijd op. Wanneer dit certificaat is verlopen, kunt u de opstartbare media niet gebruiken. Gebruik de parameter -CertificateStartTime om de begindatum in te stellen.
Bijvoorbeeld:
$date = [datetime]::p arseexact("11/16/2021", 'MM/dd/yyyyy', $null)
Type: DateTime
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-CertificatePassword
Als u de parameter -CertificatePath gebruikt om een PKI-certificaat voor HTTPS-communicatie te importeren, gebruikt u deze parameter om het wachtwoord voor het certificaatbestand op te geven.
Type: SecureString
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-CertificatePath
Geef het pad op naar een PKI-certificaat dat u wilt importeren. Gebruik de parameter -CertificatePassword om het wachtwoord voor dit certificaatbestand op te geven. Gebruik deze parameters als u de site configureert voor HTTPS-clientcommunicatie.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-CertificateStartTime
Als u een zelf-ondertekend certificaat voor HTTP-communicatie wilt maken, geeft deze parameter de begindatum en -tijd van het certificaat op. Gebruik de parameter -CertificateExpireTime om de vervaldatum in te stellen. U kunt de opstartbare media pas op deze datum gebruiken.
Bijvoorbeeld:
$date = [datetime]::p arseexact("11/16/2020", 'MM/dd/yyyy', $null)
Type: DateTime
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
-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
-DistributionPoint
Geef een of meer distributiepuntobjecten op waarop u de opstartafbeelding hebt gedistribueerd. Gebruik de cmdlet Get-CMDistributionPoint om dit object op te halen.
Type: IResultObject[]
Parameter Sets: (All)
Aliases: DistributionPoints
Required: True
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
-FormatMedia
Als het MediaType is, kunt u deze parameter toevoegen om het verwisselbare USB-station in te delen als Usb FAT32 en het opstartbaar te maken.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ManagementPoint
Geef een of meer beheerpuntobjecten op die de media in de eerste communicatie gebruiken. Gebruik de parameter -MediaMode om te bepalen hoe de media communiceren wanneer deze wordt uitgevoerd. Gebruik de cmdlet Get-CMManagementPoint om dit object op te halen.
Type: IResultObject[]
Parameter Sets: (All)
Aliases: ManagementPoints
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-MediaMode
Geef op hoe de client een beheerpunt vindt om implementatiegegevens op te halen:
Dynamic: De media maken contact met een beheerpunt, waardoor de client wordt omgeleid naar een ander beheerpunt op basis van de clientlocatie in de sitegrenzen.SiteBased: De media communiceren het beheerpunt dat is opgegeven met de parameter -ManagementPoint.
Type: MediaMode
Parameter Sets: (All)
Aliases:
Accepted values: Dynamic, SiteBased
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-MediaPassword
Geef een veilig tekenreekswachtwoord op om de takenreeksmedia te beveiligen. Wanneer u een apparaat met dit medium opstart, moet u het wachtwoord invoeren om door te gaan.
Type: SecureString
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-MediaType
Geef op of het medium een cd/dvd-set of een verwisselbaar USB-station is.
Type: MediaInputType
Parameter Sets: (All)
Aliases:
Accepted values: Usb, CdDvd
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-NoAutoRun
Voeg deze parameter toe om het bestand autorun.inf op de media op te nemen. Configuration Manager voegt deze niet standaard toe. Dit bestand wordt doorgaans geblokkeerd door antimalwareproducten. Zie creating an AutoRun-enabled CD-ROM Application (Een cd-rom-toepassing met autorunfunctiemaken) voor meer informatie over de functie AutoRun van Windows. Voeg indien nodig voor uw scenario deze parameter toe om het bestand op te nemen.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Path
Als mediatype CdDvd is, geeft u de naam en het pad op waar Configuration Manager uitvoerbestanden schrijft. Bijvoorbeeld C:\output\boot.iso.
Type: String
Parameter Sets: (All)
Aliases: MediaPath, OutputPath, DriveName
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-PrestartCommand
Geef een prestart-opdracht op die wordt uitgevoerd vóór de takenreeks. Een prestart-opdracht is een script of een uitvoerbaar bestand dat kan communiceren met de gebruiker in Windows PE voordat de takenreeks wordt uitgevoerd om het besturingssysteem te installeren. Als de opdracht niet standaard is voor het Windows PE, gebruikt u PrestartPackage om bestanden voor de opdracht op te nemen.
Type: String
Parameter Sets: (All)
Aliases: PreExecCommandLine
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-PrestartPackage
Als u de parameter PrestartCommand gebruikt, gebruikt u deze parameter om een pakket op te geven dat bestanden bevat voor de prestart-opdracht. Gebruik de cmdlet Get-CMPackage om het pakketobject op te halen.
Type: IResultObject
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-SiteCode
Is van toepassing op versie 2010 en hoger. Gebruik deze parameter met de parameter ManagementPoint om de sitecode op te geven.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-TemporaryFolder
Het proces voor het maken van media kan veel tijdelijke schijfruimte vereisen. Standaard gebruikt Configuration Manager de tijdelijke map van de huidige gebruiker: $env:temp . Bijvoorbeeld C:\Users\jqpublic\AppData\Local\Temp\. Om u meer flexibiliteit te bieden bij het opslaan van deze tijdelijke bestanden, geeft u een aangepaste locatie op voor tijdelijke faseringsgegevens.
Type: String
Parameter Sets: (All)
Aliases: TemporaryDirectory, StagingArea
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-UserDeviceAffinity
Geef op hoe u wilt dat de media gebruikers aan de doelcomputer koppelen om op gebruikers gericht beheer in een Configuration Manager ondersteunen. Zie Gebruikers koppelen aan een doelcomputer voor meer informatie over hoe besturingssysteemimplementatie ondersteuning biedt voor affiniteit tussen gebruikers en apparaten.
DoNotAllow: Geen affiniteit tussen gebruikers en apparaten toestaan. De media koppelen geen gebruikers aan de doelcomputer. In dit scenario koppelt de takenreeks geen gebruikers aan de doelcomputer wanneer het besturingssysteem wordt geïmplementeerd.AdministratorApproval: Sta affiniteit tussen gebruikers en apparaten toe in afwachting van goedkeuring door de beheerder. De media koppelt gebruikers aan de doelcomputer nadat u goedkeuring hebt verleend. Deze functionaliteit is gebaseerd op het bereik van de takenreeks die het besturingssysteem implementeert. In dit scenario maakt de takenreeks een relatie tussen de opgegeven gebruikers en de doelcomputer. Vervolgens wordt er gewacht op goedkeuring van een gebruiker met beheerdersrol voordat het besturingssysteem wordt geïmplementeerd.AutoApproval: Gebruikersapparaat affiniteit met automatische goedkeuring toestaan. De media koppelt gebruikers automatisch aan de doelcomputer. Deze functionaliteit is gebaseerd op de acties van de takenreeks die het besturingssysteem implementeert. In dit scenario maakt de takenreeks een relatie tussen de opgegeven gebruikers en de doelcomputer wanneer het besturingssysteem op de doelcomputer wordt geïmplementeerd.
Type: UserDeviceAffinityType
Parameter Sets: (All)
Aliases:
Accepted values: DoNotAllow, AdministratorApproval, AutoApproval
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Variabele
Geef een of meer takenreeksvariabelen en -waarden op in een hashtabel. Een takenreeksvariabele is een naam/waarde-paar dat wordt gebruikt tijdens de implementatie van de takenreeks.
Type: Hashtable
Parameter Sets: (All)
Aliases: TaskSequenceVariables, Variables
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.
INPUTS
Geen
OUTPUTS
System.Object
OPMERKINGEN
RELATED LINKS
New-CMPrestageMedia New-CMCaptureMedia New-CMStandaloneMedia