New-CMPrestageMedia

SYNOPSIS

Utwórz plik wstępnie przygotowanego nośnika wdrożenia systemu operacyjnego.

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

Polecenie cmdlet New-CMPrestageMedia tworzy plik w celu wstępnego przygotowanego obrazu systemu operacyjnego na nowym dysku twardym. Aby uzyskać więcej informacji, zobacz Planowanie wstępnie przygotowanego nośnika.

Uwaga

Uruchom Menedżer konfiguracji cmdlet z dysku Menedżer konfiguracji lokacji, na przykład PS XYZ:\> . Aby uzyskać więcej informacji, zobacz wprowadzenie.

EXAMPLES

Przykład 1: Tworzenie wstępnie przygotowanego nośnika

Pierwsze polecenie pobiera obiekt punktu zarządzania serwera systemu lokacji o nazwie mp01.contoso.com w kodzie lokacji CM1 i zapisuje obiekt w zmiennej $ManagementPoint lokacji.

Drugie polecenie pobiera obiekt obrazu rozruchowego o nazwie BootImage01 i zapisuje obiekt w zmiennej $BootImage rozruchu.

Trzecie polecenie pobiera obiekt punktu dystrybucji serwera systemu lokacji o nazwie dist01.contoso.com w kodzie lokacji CM1 i zapisuje obiekt w zmiennej $DistributionPoint lokacji.

Czwarte polecenie pobiera obiekt obrazu systemu operacyjnego o nazwie OSImagePkg01 i zapisuje obiekt w $OSImage zmiennej.

Ostatnie polecenie tworzy plik dynamicznego wstępnie przygotowanego nośnika o nazwie PrestagedMedia.wim z obrazem rozruchowym przechowywanym w programie $BootImage, punktem dystrybucji przechowywanym w programie $DistributionPoint, punktem zarządzania przechowywanym w programie $ManagementPoint i obrazem systemu operacyjnego przechowywanym w programie $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

Dodaj ten parametr, aby Windows monitować o podniesienie uprawnień administratora za pomocą kontroli konta użytkownika. To polecenie cmdlet wymaga podwyższonego poziomu uprawnień do uruchomienia.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-AllowUnattended

Dodaj ten parametr, aby zezwolić na nienadzorowane wdrożenie systemu operacyjnego. Nienadzorowane wdrożenie systemu operacyjnego nie monituje o konfigurację sieci ani opcjonalne sekwencje zadań.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-AllowUnknownMachine

Dodaj ten parametr, aby umożliwić Menedżer konfiguracji aprowizować nieznane komputery. Nieznany komputer to komputer, który nie został jeszcze odnaleziony w lokacji.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Aplikacji

Określ tablicę obiektów aplikacji, które mają być dołączane jako część pliku multimedialnego. Jeśli sekwencja zadań odwołuje się do tej zawartości, najpierw wyszukuje ją lokalnie. Jeśli zawartość nie znajduje się na nośniku, sekwencja zadań próbuje pobrać ją z sieci w zwykły sposób. Aby uzyskać obiekt aplikacji, użyj polecenia cmdlet 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

Określ obiekt obrazu rozruchowego. Aby uzyskać ten obiekt, użyj polecenia cmdlet 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

Jeśli tworzysz certyfikat nośnika z podpisem własnym na temat komunikacji HTTP, ten parametr określa datę i czas wygaśnięcia certyfikatu. Określ odpowiednio datę/godzinę w przyszłości. Po wygaśnięciu tego certyfikatu nie można używać nośnika rozruchowego. Użyj parametru -CertificateStartTime, aby ustawić datę rozpoczęcia.

Na przykład:

$date = [datetime]::p arseexact("11/16/2021", '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

Jeśli używasz parametru -CertificatePath do zaimportowania certyfikatu PKI do komunikacji HTTPS, użyj tego parametru, aby określić hasło dla pliku certyfikatu.

Type: SecureString
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-CertificatePath

Określ ścieżkę do certyfikatu PKI do zaimportowania. Użyj parametru -CertificatePassword, aby określić hasło dla tego pliku certyfikatu. Użyj tych parametrów, jeśli skonfigurujesz lokację do komunikacji z klientem HTTPS.

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-CertificateStartTime

Aby utworzyć certyfikat z podpisem własnym dla komunikacji HTTP, ten parametr określa datę i godzina rozpoczęcia certyfikatu. Użyj parametru -CertificateExpireTime, aby ustawić datę wygaśnięcia. Do tej daty nie można używać nośnika rozruchowego.

Na przykład:

$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

-Komentarz

Opcjonalny ciąg, który zawiera dodatkowe szczegóły dotyczące nośnika. Warto opisać sposób konfigurowania i używania tego nośnika. Maksymalna długość wynosi 127 znaków.

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Confirm

Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.

Type: SwitchParameter
Parameter Sets: (All)
Aliases: cf

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-CreatedBy

Opcjonalny ciąg określający, kto utworzył ten nośnik, co jest przydatne do celów śledzenia. Maksymalna długość wynosi 50 znaków.

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-DisableWildcardHandling

Ten parametr traktuje symbole wieloznaczne jako wartości znaków literału. Nie można połączyć go z forceWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-DistributionPoint

Określ co najmniej jeden obiekt punktu dystrybucji, do którego ma być dystrybuowana zawartość tego nośnika. Aby uzyskać ten obiekt, użyj polecenia cmdlet 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

Określ tablicę obiektów pakietu sterowników, które mają być dołączane jako część pliku multimedialnego. Jeśli sekwencja zadań odwołuje się do tej zawartości, wyszukuje ją lokalnie. Jeśli zawartość nie znajduje się na nośniku, sekwencja zadań próbuje pobrać ją z sieci w zwykły sposób. Aby uzyskać ten obiekt, użyj polecenia cmdlet 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

Uruchom polecenie bez pytania o potwierdzenie.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-ForceWildcardHandling

Ten parametr przetwarza symbole wieloznaczne i może prowadzić do nieoczekiwanego zachowania (nie jest zalecane). Nie można połączyć go z disableWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-IncludeApplicationDependency

Dodaj ten parametr, aby wykryć skojarzone zależności aplikacji i dodać je do tego nośnika.

Type: SwitchParameter
Parameter Sets: (All)
Aliases: IncludeApplicationDependencies

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-ManagementPoint

Określ co najmniej jeden obiekt punktu zarządzania używany przez nośnik w początkowej komunikacji. Użyj parametru -MediaMode, aby określić, jak nośnik komunikuje się po jego użyciu. Aby uzyskać ten obiekt, użyj polecenia cmdlet 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

Określ sposób, w jaki klient znajduje punkt zarządzania w celu uzyskania informacji o wdrożeniu:

  • Dynamic: nośnik kontaktuje się z punktem zarządzania, który przekierowuje klienta do innego punktu zarządzania na podstawie lokalizacji klienta w granicach lokacji.

  • SiteBased: nośnik komunikuje punkt zarządzania określony za pomocą parametru -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

Określ bezpieczne hasło ciągu, aby chronić nośnik sekwencji zadań. Podczas rozruchu urządzenia z tym nośnikiem należy wprowadzić hasło, aby kontynuować.

Type: SecureString
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-NoAutoRun

Dodaj ten parametr, aby uwzględnić plik autorun.inf na nośniku. Menedżer konfiguracji nie dodaje go domyślnie. Ten plik jest często blokowany przez produkty ochrony przed złośliwym oprogramowaniem. Aby uzyskać więcej informacji na temat funkcji AutoRun Windows, zobacz Creating an AutoRun-enabled CD-ROM Application(Tworzenie aplikacji CD-ROM z włączoną funkcją AutoRun). Jeśli nadal jest to konieczne w twoim scenariuszu, dodaj ten parametr, aby dołączyć plik.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-OperatingSystemImage

Określ obiekt pakietu obrazu systemu operacyjnego, który ma być uwzględniany na tym nośniku. Użyj operatingSystemImageIndex parametru, aby określić indeks obrazu w pakiecie obrazu. Aby uzyskać ten obiekt, użyj polecenia cmdlet 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

Określ indeks obrazu w pakiecie obrazów za pomocą parametru OperatingSystemImage.

Type: Int32
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Package

Określ tablicę obiektów pakietu, które mają być dołączane do pliku multimedialnego. Jeśli sekwencja zadań odwołuje się do tej zawartości, wyszukuje ją lokalnie. Jeśli zawartość nie znajduje się na nośniku, sekwencja zadań próbuje pobrać ją z sieci w zwykły sposób. Aby uzyskać ten obiekt, użyj polecenia cmdlet 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

Ścieżka do pliku multimedialnego do utworzenia. Format to ścieżka dysku/katalogu lub prawidłowa ścieżka sieciowa. Na przykład:

  • 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

Określ wiersz polecenia do uruchomienia przed uruchomieniem sekwencji zadań. Aby uzyskać więcej informacji, zobacz Polecenia przedstartowe dla nośnika sekwencji zadań.

Type: String
Parameter Sets: (All)
Aliases: PreExecCommandLine

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-PrestartPackage

W przypadku określenia parametru PrestartCommand użyj tego parametru, aby w razie potrzeby określić pakiet zawartości przedstartowej.

Type: IResultObject
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-SiteCode (Kod lokacji)

Dotyczy wersji 2010 i nowszych. Użyj tego parametru z parametrem ManagementPoint, aby określić kod lokacji.

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-TaskSequence

Określ obiekt sekwencji zadań do uruchomienia na tym nośniku. Aby uzyskać ten obiekt, użyj polecenia cmdlet Get-CMTaskSequence.

Type: IResultObject
Parameter Sets: (All)
Aliases:

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-TemporaryFolder

Proces tworzenia nośnika może wymagać dużo miejsca na dysku tymczasowym. Domyślnie program Menedżer konfiguracji katalog tymczasowy bieżącego użytkownika: $env:temp . Na przykład C:\Users\jqpublic\AppData\Local\Temp\. Aby zapewnić większą elastyczność przechowywania tych plików tymczasowych, określ niestandardową lokalizację tymczasowych danych.

Type: String
Parameter Sets: (All)
Aliases: TemporaryDirectory, StagingArea

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-UserDeviceAffinity (Koligacja użytkownika)

Aby obsługiwać zarządzanie zorientowane na użytkownika w programie Menedżer konfiguracji, określ sposób kojarzenia użytkowników z komputerem docelowym za pomocą nośnika. Aby uzyskać więcej informacji na temat sposobu obsługi koligacji urządzenia użytkownika przez wdrożenie systemu operacyjnego, zobacz Kojarzenie użytkowników z komputerem docelowym.

  • DoNotAllow: nie zezwalaj na koligacja urządzenia użytkownika. Nośnik nie kojarzy użytkowników z komputerem docelowym. W tym scenariuszu sekwencja zadań nie kojarzy użytkowników z komputerem docelowym podczas wdrażania systemu operacyjnego.

  • AdministratorApproval: zezwalaj na koligacja urządzenia użytkownika w oczekiwaniu na zatwierdzenie przez administratora. Nośnik kojarzy użytkowników z komputerem docelowym po udzieleniu zatwierdzenia. Ta funkcja jest oparta na zakresie sekwencji zadań, która wdraża system operacyjny. W tym scenariuszu sekwencja zadań tworzy relację między określonymi użytkownikami a komputerem docelowym. Następnie czeka na zatwierdzenie przez użytkownika administracyjnego przed wdrożeniem systemu operacyjnego.

  • AutoApproval: zezwala na koligacja urządzenia użytkownika z automatycznym zatwierdzaniem. Nośnik automatycznie kojarzy użytkowników z komputerem docelowym. Ta funkcja jest oparta na akcjach sekwencji zadań, która wdraża system operacyjny. W tym scenariuszu sekwencja zadań tworzy relację między określonymi użytkownikami i komputerem docelowym podczas wdrażania systemu operacyjnego na komputerze docelowym.

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

-Variable (Zmienna)

Określ tabelę skrótów zmiennych sekwencji zadań do użycia podczas wdrażania sekwencji zadań z tego nośnika.

Type: Hashtable
Parameter Sets: (All)
Aliases: TaskSequenceVariables, Variables

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Version (Wersja)

Opcjonalna wartość ciągu określająca wersję tego nośnika, która jest przydatna do śledzenia i poprawek. Maksymalna długość wynosi 32 znaki.

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-WhatIf

Pokazuje, co się stanie po uruchomieniu polecenia cmdlet. Polecenie cmdlet nie jest uruchamiane.

Type: SwitchParameter
Parameter Sets: (All)
Aliases: wi

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

Typowe parametry

To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters.

INPUTS

Brak

OUTPUTS

System.Object

UWAGI

Aliasy polecenia cmdlet: New-CMPrestagedMedia

Get-CMApplication

Get-CMBootImage

Get-CMDistributionPoint

Get-CMDriverPackage

Get-CMManagementPoint

Get-CMOperatingSystemImage

Get-CMPackage

Planowanie wstępnie przygotowanego nośnika