Delen via


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

Get-CMBootImage

Get-CMDistributionPoint

Get-CMManagementPoint

Get-CMPackage

New-CMPrestageMedia New-CMCaptureMedia New-CMStandaloneMedia