New-CMPrestageMedia
SYNOPSIS
Skapa en förinstallerad mediefil för operativsystemdistribution.
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
Cmdleten New-CMPrestageMedia skapar en fil för att förinstallera en OS-avbildning på en ny hårddisk. Mer information finns i Planera förinstallerade media.
Anteckning
Kör Konfigurationshanteraren cmdlets från Konfigurationshanteraren platsenheten, till exempel PS XYZ:\> . Mer information finns i Komma igång.
EXAMPLES
Exempel 1: Skapa förinstallerade media
Det första kommandot hämtar hanteringsplatsobjektet för platssystemservern med namnet mp01.contoso.com i platskoden CM1 och lagrar objektet i $ManagementPoint variabeln.
Det andra kommandot hämtar startavbildningsobjektet med namnet BootImage01 och lagrar objektet i $BootImage variabeln.
Det tredje kommandot hämtar distributionsplatsens objekt för platssystemservern med namnet dist01.contoso.com i platskoden CM1 och lagrar objektet i $DistributionPoint variabeln.
Det fjärde kommandot hämtar OS-avbildningsobjektet med namnet OSImagePkg01 och lagrar objektet i $OSImage variabeln.
Det sista kommandot skapar en dynamisk förinstallerad mediefil med namnet PrestagedMedia.wim med startavbildningen som lagras i $BootImage, distributionsplatsen som lagras i $DistributionPoint, hanteringsplatsen som lagras i $ManagementPoint och OS-avbildningen som lagras i $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
Lägg till den här parametern så Windows att du uppmanas att höja dina administratörsbehörigheter User Account Control (UAC). Den här cmdleten kräver förhöjd behörighet för att köras.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-AllowUnattended
Lägg till den här parametern för att tillåta en obevakad distribution av operativsystemet. En obevakad os-distribution frågar inte efter nätverkskonfiguration eller valfria aktivitetssekvenser.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-AllowUnknownMachine
Lägg till den här parametern för Konfigurationshanteraren att etablera okända datorer. En okänd dator är en dator som platsen inte har identifierat ännu.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Program
Ange en matris med programobjekt som ska inkluderas som en del av mediefilen. Om aktivitetssekvensen refererar till det här innehållet söker den först lokalt efter innehållet. Om innehållet inte finns på mediet försöker aktivitetssekvensen ladda ned det från nätverket som vanligt. Om du vill hämta ett programobjekt använder du cmdleten Get-CMApplication.
Type: IResultObject[]
Parameter Sets: (All)
Aliases: Applications
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-BootImage
Ange ett startavbildningsobjekt. Hämta det här objektet med cmdleten Get-CMBootImage.
Type: IResultObject
Parameter Sets: (All)
Aliases: BootImagePackage
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-CertificateExpireTime
Om du skapar ett själv signerat mediecertifikat för HTTP-kommunikation anger den här parametern certifikatets förfallodatum och tid. Ange en datetime tillräckligt i framtiden. När det här certifikatet upphör att gälla kan du inte använda det startbara mediet. Använd parametern -CertificateStartTime för att ange startdatumet.
Ett exempel:
$date = [datetime]::p arseexact("2021-11-16", "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
-CertificatePassword
Om du använder parametern -CertificatePath för att importera ett PKI-certifikat för HTTPS-kommunikation använder du den här parametern för att ange lösenordet för certifikatfilen.
Type: SecureString
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-CertificatePath
Ange sökvägen till ett PKI-certifikat som ska importeras. Använd parametern -CertificatePassword för att ange lösenordet för den här certifikatfilen. Använd de här parametrarna om du konfigurerar platsen för HTTPS-klientkommunikation.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-CertificateStartTime
Om du vill skapa ett själv signerat certifikat för HTTP-kommunikation anger den här parametern certifikatets startdatum och -tid. Använd parametern -CertificateExpireTime för att ange förfallodatumet. Du kan inte använda det startbara mediet förrän det här datumet.
Ett exempel:
$date = [datetime]::p arseexact("2020-11-16", "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
-Kommentar
En valfri sträng som ger ytterligare information om mediet. Det är användbart att beskriva hur du har konfigurerat eller hur du ska använda det här mediet. Den maximala längden är 127 tecken.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Confirm
Uppmanar dig att bekräfta innan du kör cmdleten.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: cf
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-CreatedBy
En valfri sträng för att ange vem som skapade mediet, vilket är användbart i spårningssyfte. Den maximala längden är 50 tecken.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DisableWildcardHandling
Den här parametern behandlar jokertecken som värden för literaltecken. Du kan inte kombinera den med ForceWildcardHandling.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DistributionPoint
Ange ett eller flera distributionsplatsobjekt som du har distribuerat innehållet till för det här mediet. Hämta det här objektet med hjälp av cmdleten Get-CMDistributionPoint.
Type: IResultObject[]
Parameter Sets: (All)
Aliases: DistributionPoints
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DriverPackage
Ange en matris med drivrutinspaketobjekt som ska ingå som en del av mediefilen. Om aktivitetssekvensen refererar till det här innehållet söker den lokalt efter innehållet. Om innehållet inte finns på mediet försöker aktivitetssekvensen ladda ned det från nätverket som vanligt. Hämta det här objektet med hjälp av cmdleten Get-CMDriverPackage.
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
Kör kommandot utan att be om bekräftelse.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ForceWildcardHandling
Den här parametern bearbetar jokertecken och kan leda till oväntat beteende (rekommenderas inte). Du kan inte kombinera den med DisableWildcardHandling.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-IncludeApplicationDependency
Lägg till den här parametern för att identifiera associerade programberoenden och lägga till dem på det här mediet.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: IncludeApplicationDependencies
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ManagementPoint
Ange ett eller flera hanteringsplatsobjekt som mediet använder vid inledande kommunikation. Använd parametern -MediaMode för att avgöra hur mediet kommunicerar när det körs. Hämta det här objektet med hjälp av cmdleten Get-CMManagementPoint.
Type: IResultObject[]
Parameter Sets: (All)
Aliases: ManagementPoints
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-MediaMode
Ange hur klienten hittar en hanteringsplats för att hämta distributionsinformation:
Dynamic: Mediet kontaktar en hanteringsplats, som omdirigerar klienten till en annan hanteringsplats baserat på klientens plats i platsgränserna.SiteBased: Mediet kommunicerar hanteringsplatsen som angetts med parametern -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
Ange ett säkert stränglösenord för att skydda aktivitetssekvensmediet. När du startar en enhet med det här mediet måste du ange lösenordet för att fortsätta.
Type: SecureString
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-NoAutoRun
Lägg till den här parametern för att inkludera filen autorun.inf på mediet. Konfigurationshanteraren lägger inte till den som standard. Den här filen blockeras ofta av produkter mot skadlig programvara. Mer information om funktionen AutoRun i Windows finns i Creating an AutoRun-enabled CD-ROM Application ( Skapa ett AutoRun-aktiverat CD-ROM-program). Om det fortfarande behövs för ditt scenario lägger du till den här parametern för att inkludera filen.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-OperatingSystemImage
Ange ett objekt för os-avbildningspaket som ska inkluderas för det här mediet. Använd parametern OperatingSystemImageIndex för att ange avbildningsindexet i avbildningspaketet. Hämta det här objektet med cmdleten Get-CMOperatingSystemImage.
Type: IResultObject
Parameter Sets: (All)
Aliases: OperatingSystemImagePackage
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-OperatingSystemImageIndex
Ange avbildningsindexet i avbildningspaketet från parametern OperatingSystemImage.
Type: Int32
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Paket
Ange en matris med paketobjekt som ska ingå i mediefilen. Om aktivitetssekvensen refererar till det här innehållet söker den lokalt efter innehållet. Om innehållet inte finns på mediet försöker aktivitetssekvensen ladda ned det från nätverket som vanligt. Hämta det här objektet med cmdleten Get-CMPackage.
Type: IResultObject[]
Parameter Sets: (All)
Aliases: Packages
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Path
Sökvägen till mediefilen som ska skapas. Formatet är antingen en enhets-/katalogsökväg eller en giltig nätverkssökväg. Ett exempel:
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
Ange en kommandorad som ska köras innan aktivitetssekvensen startar. Mer information finns i Förinstartskommandon för aktivitetssekvensmediet.
Type: String
Parameter Sets: (All)
Aliases: PreExecCommandLine
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-PrestartPackage
Om du anger ett PrestartCommand använder du den här parametern för att ange ett paket för förinstartsinnehåll om det behövs.
Type: IResultObject
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-SiteCode
Gäller för version 2010 och senare. Använd den här parametern med parametern ManagementPoint för att ange platskoden.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-TaskSequence
Ange ett aktivitetssekvensobjekt för det här mediet som ska köras. Hämta det här objektet med cmdleten Get-CMTaskSequence.
Type: IResultObject
Parameter Sets: (All)
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-TemporaryFolder
Processen för att skapa media kan kräva mycket tillfälligt diskutrymme. Som standard Konfigurationshanteraren den tillfälliga katalogen för den aktuella användaren: $env:temp . Till exempel C:\Users\jqpublic\AppData\Local\Temp\. Ange en anpassad plats för mellanlagring av tillfälliga data för att ge dig större flexibilitet med var de här temporära filerna ska lagras.
Type: String
Parameter Sets: (All)
Aliases: TemporaryDirectory, StagingArea
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-UserDeviceAffinity
För att stödja användarcentrerad hantering i Konfigurationshanteraren anger du hur mediet ska associera användare med måldatorn. Mer information om hur OS-distributionen stöder mappning mellan användare och enheter finns i Associera användare med en måldator.
DoNotAllow: Tillåt inte mappning mellan användare och enhet. Mediet associerar inte användare med måldatorn. I det här scenariot associerar aktivitetssekvensen inte användare med måldatorn när operativsystemet distribueras.AdministratorApproval: Tillåt mappning mellan användare och enhet i väntan på administratörsgodkännande. Mediet associerar användare med måldatorn när du har beviljat godkännande. Den här funktionen baseras på omfånget för den aktivitetssekvens som distribuerar operativsystemet. I det här scenariot skapar aktivitetssekvensen en relation mellan de angivna användarna och måldatorn. Den väntar sedan på godkännande från en administrativ användare innan den distribuerar operativsystemet.AutoApproval: Tillåt mappning mellan användare och enhet med automatiskt godkännande. Mediet associerar automatiskt användare med måldatorn. Den här funktionen baseras på åtgärderna i den aktivitetssekvens som distribuerar operativsystemet. I det här scenariot skapar aktivitetssekvensen en relation mellan de angivna användarna och måldatorn när operativsystemet distribueras till måldatorn.
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
-Variabel
Ange en hash-tabell med aktivitetssekvensvariabler som ska användas under aktivitetssekvensdistributionen från det här mediet.
Type: Hashtable
Parameter Sets: (All)
Aliases: TaskSequenceVariables, Variables
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Version
Ett valfritt strängvärde för att ange en version för det här mediet, vilket är användbart för spårnings- och revisionssyften. Den maximala längden är 32 tecken.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-WhatIf
Visar vad som skulle hända om cmdleten kördes. Cmdleten körs inte.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: wi
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
CommonParameters
Denna cmdlet har stöd för parametrarna -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.
INPUTS
Ingen
OUTPUTS
System.Object
ANTECKNINGAR
Cmdlet-alias: New-CMPrestagedMedia