New-CMPrestageMedia

  • Artikel

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

Get-CMApplication

Get-CMBootImage

Get-CMDistributionPoint

Get-CMDriverPackage

Get-CMManagementPoint

Get-CMOperatingSystemImage

Get-CMPackage

Planera förinstallerade medier