New-CMPrestageMedia
SYNOPSIS
Maak een mediabestand met een voorgefaseerd besturingssysteemimplementatie.
SYNTAX
New-CMPrestageMedia [-Application <IResultObject[]>] [-Comment <String>] [-CreatedBy <String>]
[-DriverPackage <IResultObject[]>] [-IncludeApplicationDependency] -OperatingSystemImage <IResultObject>
[-OperatingSystemImageIndex <Int32>] [-Package <IResultObject[]>] -TaskSequence <IResultObject>
[-Version <String>] [-AllowUacPrompt] [-AllowUnattended] [-AllowUnknownMachine] -BootImage <IResultObject>
[-CertificateExpireTime <DateTime>] [-CertificatePassword <SecureString>] [-CertificatePath <String>]
[-CertificateStartTime <DateTime>] -DistributionPoint <IResultObject[]> [-Force]
-ManagementPoint <IResultObject[]> [-SiteCode <String>] -MediaMode <MediaMode> [-MediaPassword <SecureString>]
[-NoAutoRun] -Path <String> [-PrestartCommand <String>] [-PrestartPackage <IResultObject>]
[-TemporaryFolder <String>] [-UserDeviceAffinity <UserDeviceAffinityType>] [-Variable <Hashtable>]
[-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]
DESCRIPTION
Met de cmdlet New-CMPrestageMedia wordt een bestand gemaakt om een besturingssysteemafbeelding voor te zetten op een nieuwe harde schijf. Zie Voorgefaseerd medium plannen 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: Voorgefaseerd medium maken
Met de eerste opdracht wordt het beheerpuntobject voor de sitesysteemserver met de naam mp01.contoso.com in de sitecode CM1 opgeslagen en wordt het object opgeslagen in de $ManagementPoint variabele.
Met de tweede opdracht wordt het opstartafbeeldingsobject met de naam BootImage01 op de opstartopdracht en wordt het object op de $BootImage op slaat.
Met de derde opdracht wordt het distributiepuntobject voor de sitesysteemserver met de naam dist01.contoso.com in de sitecode CM1 opgeslagen en wordt het object opgeslagen in de $DistributionPoint variabele.
Met de vierde opdracht wordt het afbeeldingsobject van het besturingssysteem met de naam OSImagePkg01 op halen en wordt het object op de $OSImage op slaat.
Met de laatste opdracht maakt u een dynamisch voorgefaseerd mediabestand met de naam PrestagedMedia.wim met de opstartafbeelding die is opgeslagen in $BootImage, het distributiepunt dat is opgeslagen in $DistributionPoint, het beheerpunt dat is opgeslagen in $ManagementPoint en de besturingssysteemafbeelding die is opgeslagen in $OSImage.
$ManagementPoint = Get-CMManagementPoint -SiteSystemServerName "mp01.contoso.com" -SiteCode "CM1"
$BootImage = Get-CMBootImage -Name "BootImage01"
$DistributionPoint = Get-CMDistributionPoint -SiteSystemServerName "dist01.contoso.com" -SiteCode "CM1"
$OSImage = Get-CMOperatingSystemImage -Name "OSImagePkg01"
New-CMPrestageMedia -MediaMode Dynamic -Path "\\server\share\PrestagedMedia.wim" -BootImage $BootImage -DistributionPoint $DistributionPoint -ManagementPoint $ManagementPoint -OperatingSystemImage $OSImage
PARAMETERS
-AllowUacPrompt
Voeg deze parameter toe zodat Windows u kunt vragen om uw beheerdersmachtigingen uit te verhogen met Gebruikersaccountbeheer (UAC). Deze cmdlet vereist verhoogde machtigingen 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 implementatie van een besturingssysteem zonder toezicht toe te staan. Bij een implementatie van een besturingssysteem zonder toezicht wordt niet gevraagd 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
-Toepassing
Geef een matrix van toepassingsobjecten op die moeten worden opgeslagen als onderdeel van het mediabestand. Als de takenreeks naar deze inhoud verwijst, zoekt deze eerst lokaal naar de inhoud. Als de inhoud zich niet in de media, probeert de takenreeks deze op de normale manier van het netwerk te downloaden. Gebruik de cmdlet Get-CMApplication om een toepassingsobject op te halen.
Type: IResultObject[]
Parameter Sets: (All)
Aliases: Applications
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/yyyyy', $null)
Type: DateTime
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Opmerking
Een optionele tekenreeks voor meer informatie over de media. Het is handig om te beschrijven hoe u deze media hebt geconfigureerd of hoe u deze media gaat gebruiken. De maximale lengte is 127 tekens.
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: None
Accept pipeline input: False
Accept wildcard characters: False
-CreatedBy
Een optionele tekenreeks om op te geven wie deze media heeft gemaakt. Dit is handig voor traceringsdoeleinden. De maximale lengte is 50 tekens.
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
-DistributionPoint
Geef een of meer distributiepuntobjecten op waarop u de inhoud voor deze media 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
-DriverPackage
Geef een matrix van stuurprogrammapakketobjecten op die moeten worden opgeslagen als onderdeel van het mediabestand. Als de takenreeks naar deze inhoud verwijst, zoekt deze lokaal naar de inhoud. Als de inhoud zich niet in de media, probeert de takenreeks deze op de normale manier van het netwerk te downloaden. Gebruik de cmdlet Get-CMDriverPackage om dit object op te halen.
Type: IResultObject[]
Parameter Sets: (All)
Aliases: DriverPackages, PackageDriver, PackageDrivers
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
-IncludeApplicationDependency
Voeg deze parameter toe om gekoppelde toepassingsafhankelijkheden te detecteren en toe te voegen aan deze media.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: IncludeApplicationDependencies
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, dat de client omleiden 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
-NoAutoRun
Voeg deze parameter toe om het bestand autorun.inf op te nemen op de media. 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
-OperatingSystemImage
Geef een pakketobject voor de besturingssysteemafbeelding op dat voor deze media moet worden op te nemen. Gebruik de parameter OperatingSystemImageIndex om de afbeeldingsindex op te geven in het afbeeldingspakket. Gebruik de cmdlet Get-CMOperatingSystemImage om dit object op te halen.
Type: IResultObject
Parameter Sets: (All)
Aliases: OperatingSystemImagePackage
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-OperatingSystemImageIndex
Geef de afbeeldingsindex in het afbeeldingspakket op met de parameter OperatingSystemImage.
Type: Int32
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Package
Geef een matrix met pakketobjecten op die moeten worden opgeslagen in het mediabestand. Als de takenreeks naar deze inhoud verwijst, zoekt deze lokaal naar de inhoud. Als de inhoud zich niet in de media, probeert de takenreeks deze op de normale manier van het netwerk te downloaden. Gebruik de cmdlet Get-CMPackage om dit object op te halen.
Type: IResultObject[]
Parameter Sets: (All)
Aliases: Packages
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Path
Het pad naar het mediabestand dat u wilt maken. De indeling is een station/mappad of een geldig netwerkpad. Bijvoorbeeld:
C:\media\prestaged1.wim\\server\share\prestaged1.wim
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 opdrachtregel op die moet worden uitgevoerd voordat de takenreeks wordt gestart. Zie Prestart commands for task sequence media (Prestart-opdrachten voor takenreeksmedia) voor meer informatie.
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 een PrestartCommand opgeeft, gebruikt u deze parameter om zo nodig een pakket op te geven voor prestart-inhoud.
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
-TaskSequence
Geef een takenreeksobject op dat op deze media moet worden uitgevoerd. Gebruik de cmdlet Get-CMTaskSequence om dit object op te halen.
Type: IResultObject
Parameter Sets: (All)
Aliases:
Required: True
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 hashtabel op van takenreeksvariabelen die moeten worden gebruikt tijdens de takenreeksimplementatie vanaf deze media.
Type: Hashtable
Parameter Sets: (All)
Aliases: TaskSequenceVariables, Variables
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Versie
Een optionele tekenreekswaarde om een versie voor deze media op te geven. Dit is handig voor tracerings- en revisiedoeleinden. De maximale lengte is 32 tekens.
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: None
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
Cmdlet-aliassen: New-CMPrestagedMedia