New-CMPrestageMedia

모듈:

ConfigurationManager

OS 배포 사전 준비된 미디어 파일을 만듭니다.

구문

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

New-CMPrestageMedia cmdlet은 새 하드 드라이브에서 OS 이미지를 사전 준비할 파일을 만듭니다. 자세한 내용은 사전 준비된 미디어 계획을 참조하세요.

참고

Configuration Manager 사이트 드라이브에서 Configuration Manager cmdlet을 실행합니다(예: PS XYZ:\>). 자세한 내용은 시작을 참조하세요.

예제

예제 1: 사전 준비된 미디어 만들기

첫 번째 명령은 사이트 코드 CM1에서 mp01.contoso.com 사이트 시스템 서버의 관리 지점 개체를 가져오고 개체를 $ManagementPoint 변수에 저장합니다.

두 번째 명령은 BootImage01 이라는 부팅 이미지 개체를 가져오고 개체를 $BootImage 변수에 저장합니다.

세 번째 명령은 사이트 코드 CM1에서 dist01.contoso.com 사이트 시스템 서버의 배포 지점 개체를 가져오고 개체를 $DistributionPoint 변수에 저장합니다.

네 번째 명령은 OSImagePkg01이라는 OS 이미지 개체를 가져오고 개체를 $OSImage 변수에 저장합니다.

마지막 명령은 $BootImage 저장된 부팅 이미지, $DistributionPoint 저장된 배포 지점, $ManagementPoint 저장된 관리 지점 및 $OSImage 저장된 OS 이미지를 사용하여 PrestagedMedia.wim이라는 동적 사전 준비된 미디어 파일을 만듭니다.

$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

매개 변수

-AllowUacPrompt

Windows에서 UAC(사용자 계정 컨트롤)를 사용하여 관리자 권한을 승격하라는 메시지를 표시하도록 하려면 이 매개 변수를 추가합니다. 이 cmdlet을 실행하려면 상승된 권한이 필요합니다.

형식:	SwitchParameter
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-AllowUnattended

무인 OS 배포를 허용하려면 이 매개 변수를 추가합니다. 무인 OS 배포는 네트워크 구성 또는 선택적 작업 순서를 묻는 메시지를 표시하지 않습니다.

형식:	SwitchParameter
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-AllowUnknownMachine

Configuration Manager에서 알 수 없는 컴퓨터를 프로비전할 수 있도록 이 매개 변수를 추가합니다. 알 수 없는 컴퓨터는 사이트가 아직 검색되지 않은 컴퓨터입니다.

형식:	SwitchParameter
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-Application

미디어 파일의 일부로 포함할 애플리케이션 개체의 배열을 지정합니다. 작업 순서에서 이 콘텐츠를 참조하는 경우 먼저 로컬에서 콘텐츠를 찾습니다. 콘텐츠가 미디어에 없는 경우 작업 순서는 정상적으로 네트워크에서 다운로드하려고 시도합니다. 애플리케이션 개체를 얻으려면 Get-CMApplication cmdlet을 사용합니다.

형식:	IResultObject[]
별칭:	Applications
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-BootImage

부팅 이미지 개체를 지정합니다. 이 개체를 얻으려면 Get-CMBootImage cmdlet을 사용합니다.

형식:	IResultObject
별칭:	BootImagePackage
Position:	Named
Default value:	None
필수:	True
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-CertificateExpireTime

HTTP 통신을 위해 자체 서명된 미디어 인증서를 만드는 경우 이 매개 변수는 인증서의 만료 날짜 및 시간을 지정합니다. 나중에 날짜/시간을 충분히 지정합니다. 이 인증서가 만료되면 부팅 가능한 미디어를 사용할 수 없습니다. -CertificateStartTime 매개 변수를 사용하여 시작 날짜를 설정합니다.

예:

$date = [datetime]::p arseexact("11/16/2021", 'MM/dd/yyyy', $null)

형식:	DateTime
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-CertificatePassword

-CertificatePath 매개 변수를 사용하여 HTTPS 통신용 PKI 인증서를 가져오는 경우 이 매개 변수를 사용하여 인증서 파일의 암호를 지정합니다.

형식:	SecureString
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-CertificatePath

가져올 PKI 인증서의 경로를 지정합니다. -CertificatePassword 매개 변수를 사용하여 이 인증서 파일의 암호를 지정합니다. HTTPS 클라이언트 통신을 위해 사이트를 구성하는 경우 이러한 매개 변수를 사용합니다.

형식:	String
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-CertificateStartTime

HTTP 통신을 위해 자체 서명된 인증서를 만들려면 이 매개 변수는 인증서의 시작 날짜와 시간을 지정합니다. -CertificateExpireTime 매개 변수를 사용하여 만료 날짜를 설정합니다. 이 날짜까지 부팅 가능한 미디어를 사용할 수 없습니다.

예:

$date = [datetime]::p arseexact("11/16/2020", 'MM/dd/yyyy', $null)

형식:	DateTime
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-Comment

미디어에 대한 추가 세부 정보를 제공하는 선택적 문자열입니다. 구성 방법 또는 이 미디어를 사용하는 방법을 설명하는 데 유용합니다. 최대 길이는 127자입니다.

형식:	String
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-Confirm

cmdlet을 실행하기 전에 확인 메시지를 표시합니다.

형식:	SwitchParameter
별칭:	cf
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-CreatedBy

추적에 유용한 이 미디어를 만든 사람을 지정하는 선택적 문자열입니다. 최대 길이는 50자입니다.

형식:	String
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-DisableWildcardHandling

이 매개 변수는 와일드카드 문자를 리터럴 문자 값으로 처리합니다. ForceWildcardHandling과 결합할 수 없습니다.

형식:	SwitchParameter
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-DistributionPoint

이 미디어의 콘텐츠를 배포한 하나 이상의 배포 지점 개체를 지정합니다. 이 개체를 얻으려면 Get-CMDistributionPoint cmdlet을 사용합니다.

형식:	IResultObject[]
별칭:	DistributionPoints
Position:	Named
Default value:	None
필수:	True
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-DriverPackage

미디어 파일의 일부로 포함할 드라이버 패키지 개체의 배열을 지정합니다. 작업 순서가 이 콘텐츠를 참조하는 경우 콘텐츠가 로컬로 표시됩니다. 콘텐츠가 미디어에 없는 경우 작업 순서는 정상적으로 네트워크에서 다운로드하려고 시도합니다. 이 개체를 얻으려면 Get-CMDriverPackage cmdlet을 사용합니다.

형식:	IResultObject[]
별칭:	DriverPackages, PackageDriver, PackageDrivers
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-Force

확인을 요청하지 않고 명령을 실행합니다.

형식:	SwitchParameter
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-ForceWildcardHandling

이 매개 변수는 와일드카드 문자를 처리하고 예기치 않은 동작(권장되지 않음)으로 이어질 수 있습니다. DisableWildcardHandling과 결합할 수 없습니다.

형식:	SwitchParameter
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-IncludeApplicationDependency

이 매개 변수를 추가하여 연결된 애플리케이션 종속성을 검색하고 이 미디어에 추가합니다.

형식:	SwitchParameter
별칭:	IncludeApplicationDependencies
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-ManagementPoint

미디어가 초기 통신에서 사용하는 하나 이상의 관리 지점 개체를 지정합니다. -MediaMode 매개 변수를 사용하여 미디어가 실행 시 통신하는 방법을 결정합니다. 이 개체를 얻으려면 Get-CMManagementPoint cmdlet을 사용합니다.

형식:	IResultObject[]
별칭:	ManagementPoints
Position:	Named
Default value:	None
필수:	True
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-MediaMode

클라이언트가 배포 정보를 가져오는 관리 지점을 찾는 방법을 지정합니다.

• Dynamic: 미디어가 관리 지점에 연결하여 사이트 경계의 클라이언트 위치에 따라 클라이언트를 다른 관리 지점으로 리디렉션합니다.

• SiteBased: 미디어는 -ManagementPoint 매개 변수를 사용하여 지정된 관리 지점을 전달합니다.

형식:	MediaMode
허용되는 값:	Dynamic, SiteBased
Position:	Named
Default value:	None
필수:	True
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-MediaPassword

작업 순서 미디어를 보호하기 위해 보안 문자열 암호를 지정합니다. 이 미디어를 사용하여 디바이스를 부팅할 때 계속하려면 암호를 입력해야 합니다.

형식:	SecureString
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-NoAutoRun

미디어에 autorun.inf 파일을 포함하려면 이 매개 변수를 추가합니다. Configuration Manager는 기본적으로 추가하지 않습니다. 이 파일은 일반적으로 맬웨어 방지 제품에 의해 차단됩니다. Windows의 자동 실행 기능에 대한 자세한 내용은 자동 실행 사용 CD-ROM 애플리케이션 만들기를 참조하세요. 시나리오에 여전히 필요한 경우 파일을 포함하도록 이 매개 변수를 추가합니다.

형식:	SwitchParameter
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-OperatingSystemImage

이 미디어에 포함할 OS 이미지 패키지 개체를 지정합니다. OperatingSystemImageIndex 매개 변수를 사용하여 이미지 패키지에 이미지 인덱스를 지정합니다. 이 개체를 얻으려면 Get-CMOperatingSystemImage cmdlet을 사용합니다.

형식:	IResultObject
별칭:	OperatingSystemImagePackage
Position:	Named
Default value:	None
필수:	True
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-OperatingSystemImageIndex

OperatingSystemImage 매개 변수에서 이미지 패키지의 이미지 인덱스를 지정합니다.

형식:	Int32
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-Package

미디어 파일에 포함할 패키지 개체의 배열을 지정합니다. 작업 순서가 이 콘텐츠를 참조하는 경우 콘텐츠가 로컬로 표시됩니다. 콘텐츠가 미디어에 없는 경우 작업 순서는 정상적으로 네트워크에서 다운로드하려고 시도합니다. 이 개체를 얻으려면 Get-CMPackage cmdlet을 사용합니다.

형식:	IResultObject[]
별칭:	Packages
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-Path

만들 미디어 파일의 경로입니다. 형식은 드라이브/디렉터리 경로 또는 유효한 네트워크 경로입니다. 예:

• C:\media\prestaged1.wim
• \\server\share\prestaged1.wim

형식:	String
별칭:	MediaPath, OutputPath, DriveName
Position:	Named
Default value:	None
필수:	True
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-PrestartCommand

작업 순서가 시작되기 전에 실행할 명령줄을 지정합니다. 자세한 내용은 작업 순서 미디어에 대한 사전 시작 명령을 참조하세요.

형식:	String
별칭:	PreExecCommandLine
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-PrestartPackage

PrestartCommand를 지정하는 경우 이 매개 변수를 사용하여 필요한 경우 사전 시작 콘텐츠에 대한 패키지를 지정합니다.

형식:	IResultObject
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-SiteCode

버전 2010 이상에 적용됩니다. 이 매개 변수를 ManagementPoint 매개 변수와 함께 사용하여 사이트 코드를 지정합니다.

형식:	String
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-TaskSequence

이 미디어를 실행할 작업 순서 개체를 지정합니다. 이 개체를 얻으려면 Get-CMTaskSequence cmdlet을 사용합니다.

형식:	IResultObject
Position:	Named
Default value:	None
필수:	True
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-TemporaryFolder

미디어 생성 프로세스에는 많은 임시 드라이브 공간이 필요할 수 있습니다. 기본적으로 Configuration Manager는 현재 사용자의 $env:temp임시 디렉터리 를 사용합니다. 예를 들면 C:\Users\jqpublic\AppData\Local\Temp\와 같습니다. 이러한 임시 파일을 저장할 위치에 더 큰 유연성을 제공하려면 임시 데이터를 준비하기 위한 사용자 지정 위치를 지정합니다.

형식:	String
별칭:	TemporaryDirectory, StagingArea
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-UserDeviceAffinity

Configuration Manager에서 사용자 중심 관리를 지원하려면 미디어가 사용자를 대상 컴퓨터와 연결하는 방법을 지정합니다. OS 배포에서 사용자 디바이스 선호도를 지원하는 방법에 대한 자세한 내용은 사용자를 대상 컴퓨터와 연결을 참조하세요.

• DoNotAllow: 사용자 디바이스 선호도를 허용하지 않습니다. 미디어는 사용자를 대상 컴퓨터와 연결하지 않습니다. 이 시나리오에서 작업 순서는 OS를 배포할 때 사용자를 대상 컴퓨터와 연결하지 않습니다.

• AdministratorApproval: 관리자 승인이 보류 중인 사용자 디바이스 선호도를 허용합니다. 승인 후 미디어는 사용자를 대상 컴퓨터와 연결합니다. 이 기능은 OS를 배포하는 작업 순서의 범위를 기반으로 합니다. 이 시나리오에서 작업 순서는 지정된 사용자와 대상 컴퓨터 간에 관계를 만듭니다. 그런 다음, OS를 배포하기 전에 관리 사용자의 승인을 기다립니다.

• AutoApproval: 자동 승인을 사용하여 사용자 디바이스 선호도를 허용합니다. 미디어는 사용자를 대상 컴퓨터와 자동으로 연결합니다. 이 기능은 OS를 배포하는 작업 순서의 작업을 기반으로 합니다. 이 시나리오에서 작업 순서는 대상 컴퓨터에 OS를 배포할 때 지정된 사용자와 대상 컴퓨터 간에 관계를 만듭니다.

형식:	UserDeviceAffinityType
허용되는 값:	DoNotAllow, AdministratorApproval, AutoApproval
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-Variable

이 미디어에서 작업 순서를 배포하는 동안 사용할 작업 순서 변수의 해시 테이블을 지정합니다.

형식:	Hashtable
별칭:	TaskSequenceVariables, Variables
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-Version

추적 및 수정 목적에 유용한 이 미디어의 버전을 지정하는 선택적 문자열 값입니다. 최대 길이는 32자입니다.

형식:	String
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-WhatIf

cmdlet이 실행되면 어떻게 되는지 보여줍니다. cmdlet이 실행되지 않습니다.

형식:	SwitchParameter
별칭:	wi
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

입력

None

출력

System.Object

참고

Cmdlet 별칭: New-CMPrestagedMedia

관련 링크

• Get-CMApplication
• Get-CMBootImage
• Get-CMDistributionPoint
• Get-CMDriverPackage
• Get-CMManagementPoint
• Get-CMOperatingSystemImage
• Get-CMPackage
• 사전 준비된 미디어 계획