New-CMTSStepCaptureSystemImage

  • 참조
모듈:
ConfigurationManager

작업 순서에 추가할 수 있는 OS 이미지 캡처 단계를 만듭니다.

Syntax

New-CMTSStepCaptureSystemImage
   [-ImageCreator <String>]
   [-ImageDescription <String>]
   [-ImageVersion <String>]
   [-Password <SecureString>]
   -Path <String>
   -UserName <String>
   [-Condition <IResultObject[]>]
   [-ContinueOnError]
   [-Description <String>]
   [-Disable]
   -Name <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

이 cmdlet은 새 OS 이미지 캡처 단계 개체를 만듭니다. 그런 다음 Add-CMTaskSequenceStep cmdlet을 사용하여 단계를 작업 순서에 추가합니다. 이 단계에 대한 자세한 내용은 작업 순서 단계 정보: OS 이미지 캡처를 참조하세요.

참고

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

예제

예 1

이 예제에서는 먼저 ConvertTo-SecureString 기본 제공 cmdlet을 사용하여 사용자 암호에 대한 보안 문자열을 만듭니다. 이 메서드는 간단한 예제로 사용되지만 일반 텍스트 암호가 스크립트에 있으므로 가장 안전하지는 않습니다. 이 cmdlet 및 기타 옵션에 대한 자세한 내용은 ConvertTo-SecureString을 참조하세요.

다음 줄은 보안 문자열 암호 변수를 사용하여 OS 이미지 캡처 단계에 대한 개체를 만듭니다.

그런 다음 작업 순서 개체를 가져오고 인덱스 11의 작업 순서에 이 새 단계를 추가합니다.

$Secure_String_Pwd = ConvertTo-SecureString "P@ssW0rD!" -AsPlainText -Force

$step = New-CMTSStepCaptureSystemImage -Name "Capture OS Image" -Path "\\server\share$\images\image.wim" -UserName "contoso\_osdcapture" -Password $Secure_String_Pwd -ImageCreator "Meaghan C" -ImageDescription "The Virginia moon image" -ImageVersion "1.3b"

$tsNameOsd = "Default OS deployment"
$tsOsd = Get-CMTaskSequence -Name $tsNameOsd -Fast

$tsOsd | Add-CMTaskSequenceStep -Step $step -InsertStepStartIndex 11

매개 변수

-Condition

이 단계에서 사용할 조건 개체를 지정합니다. 이 개체를 얻으려면 작업 순서 조건 cmdlet 중 하나를 사용합니다. 예를 들어 Get-CMTSStepConditionVariable입니다.

Type:IResultObject[]
Aliases:Conditions
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

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

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ContinueOnError

이 매개 변수를 추가하여 오류 발생시 단계 옵션 계속을 사용하도록 설정합니다. 이 옵션을 사용하도록 설정하면 단계가 실패하면 작업 순서가 계속됩니다.

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

-Description

이 작업 순서 단계에 대한 선택적 설명을 지정합니다.

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

-Disable

이 매개 변수를 추가하여 이 작업 순서 단계를 사용하지 않도록 설정합니다.

Type:SwitchParameter
Aliases:DisableThisStep
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DisableWildcardHandling

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

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

-ForceWildcardHandling

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

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

-ImageCreator

OS 이미지를 만든 사용자의 이름을 지정합니다. 이 문자열은 이미지 파일에 저장됩니다.

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

-ImageDescription

캡처된 OS 이미지에 대한 설명을 지정합니다. 이 문자열은 이미지 파일에 저장됩니다.

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

-ImageVersion

캡처된 OS 이미지에 할당할 버전 번호를 지정합니다. 이 값은 문자와 숫자의 조합일 수 있습니다. 이미지 파일에 저장됩니다.

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

-Name

이 단계의 이름을 지정하여 작업 순서에서 식별합니다.

Type:String
Aliases:StepName
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Password

네트워크 공유에 대한 권한이 있는 UserName 의 암호를 지정합니다.

Type:SecureString
Aliases:CapturePassword
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Path

캡처된 OS 이미지를 저장할 때 Configuration Manager 사용하는 위치에 대한 네트워크 경로를 지정합니다.

Type:String
Aliases:CaptureDestination
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-UserName

경로 위치에 쓸 수 있는 권한이 있는 계정의 사용자 이름을 지정합니다. Password 매개 변수 도 사용합니다.

이 계정에 대한 자세한 내용은 OS 이미지 계정 캡처를 참조하세요.

Type:String
Aliases:CaptureUserName
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

입력

None

출력

IResultObject

참고

이 반환 개체 및 해당 속성에 대한 자세한 내용은 SMS_TaskSequence_CaptureSystemImageAction 서버 WMI 클래스를 참조하세요.