New-CMBootableMedia
SYNOPSIS
Skapa startbara media.
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
Den här cmdleten skapar media som används för att distribuera ett operativsystem. Startbara media innehåller startavbildningen, valfria förinstartskommandon och tillhörande filer Konfigurationshanteraren filer. Använd startbara media för att installera en ny version av Windows på en ny dator (utan dator) eller för att ersätta en befintlig dator och överföra inställningar.
Anteckning
Den här cmdleten kräver förhöjd behörighet för att köras.
Mer information finns i Översikt över aktivitetssekvensmedia.
Anteckning
Kör Konfigurationshanteraren cmdlets från Konfigurationshanteraren platsenheten, till exempel PS XYZ:\>
. Mer information finns i Komma igång.
EXAMPLES
Exempel 1: Skapa startbara media
Det första kommandot hämtar startavbildningsobjektet med namnet Startavbildning (x64) och lagrar det i $BootImage variabeln. Det andra kommandot hämtar distributionsplatsens roll för SiteServer01.Contoso.com lagrar den i $DistributionPoint variabeln. Det tredje kommandot hämtar hanteringsplatsrollen för SiteServer02.Contoso.com lagrar den i $ManagementPoint variabeln. Det sista kommandot skapar startbara media i dynamiskt läge. Den använder de objekt som lagras i de tidigare variablerna.
$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
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
-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
-Confirm
Uppmanar dig att bekräfta innan du kör cmdleten.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: cf
Required: False
Position: Named
Default value: False
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 distribuerade startavbildningen till. 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
-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
-FormatMedia
Om MediaType är kan du lägga till den här parametern för att formatera den flyttbara Usb
USB-enheten som FAT32 och göra den startbar.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
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
-MediaType
Ange om mediet är en CD/DVD-uppsättning eller en flyttbar USB-enhet.
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
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
-Path
Om MediaType är CdDvd
anger du namnet och sökvägen där Konfigurationshanteraren skriver utdatafilerna. Till exempel 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
Ange ett förinstartskommando som körs före aktivitetssekvensen. Ett förindatakommando är ett skript eller en körbar fil som kan interagera med användaren i Windows PE innan aktivitetssekvensen körs för att installera operativsystemet. Om kommandot inte är inbyggt i Windows PE använder du PrestartPackage för att inkludera filer för kommandot.
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 använder parametern PrestartCommand använder du den här parametern för att ange ett paket som innehåller filer för förinstartskommandot. Hämta paketobjektet med cmdleten Get-CMPackage.
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
-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 eller flera aktivitetssekvensvariabler och värden i en hash-tabell. En aktivitetssekvensvariabel är ett namn-/värdepar som används under aktivitetssekvensdistributionen.
Type: Hashtable
Parameter Sets: (All)
Aliases: TaskSequenceVariables, Variables
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: False
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
RELATED LINKS
New-CMPrestageMedia New-CMCaptureMedia New-CMStandaloneMedia