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