New-CMSoftwareUpdatePhase

모듈:

ConfigurationManager

이 cmdlet을 사용하여 소프트웨어 업데이트에 대한 배포 단계를 만듭니다.

구문

New-CMSoftwareUpdatePhase
   [-AlertDelta <Int32>]
   [-AlertThresholdPercentage <Int32>]
   [-AlertUnit <TimeUnitType>]
   [-AllowMeteredConnection <Boolean>]
   [-AllowSystemRestart <Boolean>]
   [-AllowWumuFallback <Boolean>]
   [-BeginCondition <BeginConditionType>]
   [-Collection] <IResultObject>
   [-CriteriaOption <CriteriaType>]
   [-CriteriaValue <Int32>]
   [-DaysAfterPreviousPhaseSuccess <Int32>]
   [-DeadlineUnit <TimeUnitType>]
   [-DeadlineValue <Int32>]
   [-DisableScomAlert <Boolean>]
   [-EnableAlert <Boolean>]
   [-EnableWakeOnLan <Boolean>]
   [-GenerateScomAlertOnFailure <Boolean>]
   [-InstallationChoice <InstallationChoiceType>]
   [-PhaseDescription <String>]
   -PhaseName <String>
   [-RequirePostRebootFullScan <Boolean>]
   [-ServerRestartSuppression <Boolean>]
   [-SoftwareInstallation <Boolean>]
   [-StateMessageVerbosity <VerbosityLevelType>]
   [-ThrottlingDays <Int32>]
   [-UseNeighborDP <Boolean>]
   [-UserNotificationOption <UserNotificationType>]
   [-UseSiteDefaultDP <Boolean>]
   [-WorkstationRestartSuppression <Boolean>]
   [-WriteFilterCommit <Boolean>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-CMSoftwareUpdatePhase
   [-AlertDelta <Int32>]
   [-AlertThresholdPercentage <Int32>]
   [-AlertUnit <TimeUnitType>]
   [-AllowMeteredConnection <Boolean>]
   [-AllowSystemRestart <Boolean>]
   [-AllowWumuFallback <Boolean>]
   [-BeginCondition <BeginConditionType>]
   [-CollectionId] <String>
   [-CriteriaOption <CriteriaType>]
   [-CriteriaValue <Int32>]
   [-DaysAfterPreviousPhaseSuccess <Int32>]
   [-DeadlineUnit <TimeUnitType>]
   [-DeadlineValue <Int32>]
   [-DisableScomAlert <Boolean>]
   [-EnableAlert <Boolean>]
   [-EnableWakeOnLan <Boolean>]
   [-GenerateScomAlertOnFailure <Boolean>]
   [-InstallationChoice <InstallationChoiceType>]
   [-PhaseDescription <String>]
   -PhaseName <String>
   [-RequirePostRebootFullScan <Boolean>]
   [-ServerRestartSuppression <Boolean>]
   [-SoftwareInstallation <Boolean>]
   [-StateMessageVerbosity <VerbosityLevelType>]
   [-ThrottlingDays <Int32>]
   [-UseNeighborDP <Boolean>]
   [-UserNotificationOption <UserNotificationType>]
   [-UseSiteDefaultDP <Boolean>]
   [-WorkstationRestartSuppression <Boolean>]
   [-WriteFilterCommit <Boolean>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-CMSoftwareUpdatePhase
   [-AlertDelta <Int32>]
   [-AlertThresholdPercentage <Int32>]
   [-AlertUnit <TimeUnitType>]
   [-AllowMeteredConnection <Boolean>]
   [-AllowSystemRestart <Boolean>]
   [-AllowWumuFallback <Boolean>]
   [-BeginCondition <BeginConditionType>]
   [-CollectionName] <String>
   [-CriteriaOption <CriteriaType>]
   [-CriteriaValue <Int32>]
   [-DaysAfterPreviousPhaseSuccess <Int32>]
   [-DeadlineUnit <TimeUnitType>]
   [-DeadlineValue <Int32>]
   [-DisableScomAlert <Boolean>]
   [-EnableAlert <Boolean>]
   [-EnableWakeOnLan <Boolean>]
   [-GenerateScomAlertOnFailure <Boolean>]
   [-InstallationChoice <InstallationChoiceType>]
   [-PhaseDescription <String>]
   -PhaseName <String>
   [-RequirePostRebootFullScan <Boolean>]
   [-ServerRestartSuppression <Boolean>]
   [-SoftwareInstallation <Boolean>]
   [-StateMessageVerbosity <VerbosityLevelType>]
   [-ThrottlingDays <Int32>]
   [-UseNeighborDP <Boolean>]
   [-UserNotificationOption <UserNotificationType>]
   [-UseSiteDefaultDP <Boolean>]
   [-WorkstationRestartSuppression <Boolean>]
   [-WriteFilterCommit <Boolean>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

이 cmdlet을 사용하여 소프트웨어 업데이트에 대한 배포 단계를 만듭니다.

예제

예제 1: 소프트웨어 업데이트 단계 만들기

이 예제에서는 소프트웨어 센터에만 표시되는 MyCollection이라는 컬렉션에 대해 MySUPhase라는 소프트웨어 업데이트 단계를 만듭니다.

New-CMSoftwareUpdatePhase `
 -CollectionName "MyCollection" `
 -PhaseName "MySUPhase" `
 -UserNotificationOption DisplaySoftwareCenterOnly

매개 변수

-AlertDelta

이 매개 변수는 콘솔에서 단계 추가 마법사의 경고 페이지에 있는 다음 설정과 동일합니다. 마감일부터 오프셋합니다. 오프셋의 정수 값을 지정한 다음 AlertUnit 매개 변수를 사용하여 마침표 형식을 지정합니다.

이 값을 설정하려면 EnableAlert 매개 변수를 사용해야 합니다.

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

-AlertThresholdPercentage

이 매개 변수는 콘솔에서 단계 추가 마법사의 경고 페이지에 있는 다음 설정과 동일합니다. 클라이언트 규정 준수는 다음(백분율) 미만입니다. 백분율에 정수 값을 지정합니다. 이 값을 설정하려면 EnableAlert 매개 변수를 사용해야 합니다.

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

-AlertUnit

마침표 유형을 지정합니다. AlertDelta에서 이 매개 변수를 사용합니다.

형식:	TimeUnitType
허용되는 값:	Hours, Days, Weeks, Months
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-AllowMeteredConnection

이 매개 변수는 콘솔에서 단계 추가 마법사의 다운로드 설정 페이지에서 다음 설정과 동일합니다. 요금제 인터넷 연결의 클라이언트가 설치 최종 기한 이후에 콘텐츠를 다운로드하도록 허용하여 추가 비용이 발생할 수 있습니다.

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

-AllowSystemRestart

이 매개 변수는 콘솔에서 단계 추가 마법사의 사용자 환경 페이지에서 시스템 다시 시작(설치를 완료하는 데 필요한 경우)의 설정과 동일합니다. 이 설정은 설치 기한에 도달하면 적용되므로 유지 관리 기간 외부에서 이 작업을 수행할 수 있습니다.

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

-AllowWumuFallback

이 매개 변수는 콘솔에서 단계 추가 마법사의 다운로드 설정 페이지에서 다음 설정과 동일합니다. 현재, 인접 또는 사이트 경계 그룹의 배포 지점에서 소프트웨어 업데이트를 사용할 수 없는 경우 Microsoft 업데이트에서 콘텐츠를 다운로드합니다.

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

-BeginCondition

이전 단계의 성공 후 이 배포 단계를 시작하기 위한 옵션을 지정합니다.

• AfterPeriod: 이 매개 변수는 콘솔에서 단계 추가 마법사의 단계 설정 페이지에서 다음 설정과 동일합니다. 지연 기간(일) 후에 이 단계를 자동으로 시작합니다. 이 값을 지정하는 경우 DaysAfterPreviousPhaseSuccess 를 사용하여 기간을 구성합니다.

• Manually: 이 매개 변수는 콘솔에서 단계 추가 마법사의 단계 설정 페이지에서 다음 설정과 동일합니다. 수동으로 이 배포 단계를 시작합니다.

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

-Collection

대상 컬렉션에 대한 개체를 지정합니다.

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

-CollectionId

ID별로 대상 컬렉션을 지정합니다.

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

-CollectionName

이름으로 대상 컬렉션을 지정합니다.

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

-Confirm

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

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

-CriteriaOption

이전 단계의 성공 조건을 선택하는 옵션을 지정합니다.

• Compliance: 이 매개 변수는 콘솔에서 단계 추가 마법사의 단계 설정 페이지에서 배포 성공률 설정과 동일합니다. CriteriaValue 매개 변수를 사용하여 백분율 값을 지정합니다.

• Number: 이 매개 변수는 콘솔에서 단계 추가 마법사의 단계 설정 페이지에서 다음 설정과 동일합니다. 성공적으로 배포된 디바이스 수입니다. CriteriaValue 매개 변수를 사용하여 디바이스 수를 지정합니다.

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

-CriteriaValue

이 정수 값은 CriteriaOption에 대해 지정한 값에 따라 달라집니다.

• Compliance: 백분율 지정

• Number: 디바이스 수 지정

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

-DaysAfterPreviousPhaseSuccess

이 단계를 시작하기 위해 이전 단계의 성공 후 일 수에 대한 정수 값을 지정합니다. 이 매개 변수는 콘솔에서 단계 추가 마법사의 단계 설정 페이지에서 다음 설정과 동일합니다. 지연 기간(일) 후에 이 단계를 자동으로 시작합니다.

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

-DeadlineUnit

최종 기한의 유형을 지정합니다. DeadlineValue에서 이 매개 변수를 사용합니다.

형식:	TimeUnitType
허용되는 값:	Hours, Days, Weeks, Months
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-DeadlineValue

이 매개 변수는 InstallationChoice 매개 변수를 사용하여 지정 AfterPeriod 하는 경우에만 사용됩니다.

마감일 기간의 정수 값을 지정합니다. DeadlineUnit 매개 변수를 사용하여 마침표 Hours형식을 지정합니다. , Days, , WeeksMonths. 이 매개 변수는 콘솔에서 단계 추가 마법사의 단계 설정 페이지에서 다음 설정과 동일합니다. 이 기간 후에 설치가 필요합니다.

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

-DisableScomAlert

이 매개 변수는 콘솔에서 단계 추가 마법사의 경고 페이지에 있는 다음 설정과 동일합니다. 소프트웨어 업데이트가 실행되는 동안 Operations Manager 경고 사용 안 함.

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

-DisableWildcardHandling

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

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

-EnableAlert

이 매개 변수는 콘솔에서 단계 추가 마법사의 경고 페이지에서 다음 설정과 동일합니다. 다음 조건이 충족되면 경고 생성. 이 매개 변수를 로 $true설정하면 다음 매개 변수도 설정합니다.

• AlertThresholdPercentage
• AlertDelta

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

-EnableWakeOnLan

이 매개 변수는 콘솔에서 단계 추가 마법사의 배포 설정 페이지에서 다음 설정과 동일합니다. Wake-on-LAN을 사용하여 필요한 배포를 위해 클라이언트를 절전 모드 해제합니다.

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

-ForceWildcardHandling

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

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

-GenerateScomAlertOnFailure

이 매개 변수는 콘솔에서 단계 추가 마법사의 경고 페이지에 있는 다음 설정과 동일합니다. 소프트웨어 업데이트 설치가 실패하면 Operations Manager 경고 생성.

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

-InstallationChoice

소프트웨어를 사용할 수 있게 된 시기를 기준으로 동작에 대한 옵션을 지정합니다.

• AsSoonAsPossible: 이 매개 변수는 콘솔에서 단계 추가 마법사의 단계 설정 페이지에서 다음 설정과 동일합니다. 가능한 한 빨리 설치가 필요합니다.

• AfterPeriod: 이 매개 변수는 콘솔에서 단계 추가 마법사의 단계 설정 페이지에서 다음 설정과 동일합니다. 이 기간 후에 설치가 필요합니다. 이 값을 지정하는 경우 DeadlineUnit 및 DeadlineValue 를 사용하여 기간을 구성합니다.

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

-PhaseDescription

단계에 대한 설명을 지정합니다.

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

-PhaseName

설명의 이름을 지정합니다.

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

-RequirePostRebootFullScan

이 매개 변수는 콘솔에서 단계 추가 마법사의 사용자 환경 페이지에서 다음 설정과 동일합니다. 이 배포의 업데이트에 시스템 다시 시작이 필요한 경우 다시 시작한 후 업데이트 배포 평가 주기를 실행합니다.

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

-ServerRestartSuppression

이 매개 변수는 콘솔의 단계 추가 마법사의 사용자 환경 페이지에서 다음 설정과 동일합니다. 다음 디바이스에서 시스템 다시 시작을 표시하지 않습니다. 서버.

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

-SoftwareInstallation

이 매개 변수는 콘솔에서 단계 추가 마법사의 사용자 환경 페이지에서 소프트웨어 설치 설정과 동일합니다. 이 설정은 설치 기한에 도달하면 적용되므로 유지 관리 기간 외부에서 이 작업을 수행할 수 있습니다.

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

-StateMessageVerbosity

이 매개 변수는 콘솔에서 단계 추가 마법사의 배포 설정 페이지에서 다음과 같은 설정과 같습니다. 상태 메시지 세부 정보 수준은 다음 값을 사용합니다.

• AllMessages: 모든 메시지
• OnlySuccessAndErrorMessages: 성공 및 오류 메시지만
• OnlyErrorMessages: 오류 메시지만

형식:	VerbosityLevelType
허용되는 값:	AllMessages, OnlySuccessAndErrorMessages, OnlyErrorMessages
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-ThrottlingDays

이 소프트웨어를 점진적으로 사용할 수 있도록 하려면 일 수의 정수 값을 지정합니다. 이 매개 변수는 콘솔에서 단계 추가 마법사의 단계 설정 페이지에서 다음 설정과 동일합니다. 이 기간(일)에 이 소프트웨어를 점진적으로 사용할 수 있도록 합니다.

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

-UseNeighborDP

이 매개 변수는 콘솔에서 단계 추가 마법사의 다운로드 설정 페이지에서 다음 설정과 동일합니다. 클라이언트가 인접 경계 그룹 또는 기본 사이트 경계 그룹의 배포 지점을 사용할 때 사용할 배포 옵션을 선택합니다. 다음 값을 지정합니다.

• $true: 배포 지점에서 소프트웨어 업데이트 다운로드 및 설치
• $false: 소프트웨어 업데이트를 설치하지 마세요.

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

-UserNotificationOption

이 매개 변수는 콘솔의 단계 추가 마법사의 사용자 환경 페이지에서 다음 설정과 동일합니다. 다음 값을 사용하여 이 배포에 대한 사용자 환경 설정을 지정합니다.

• DisplayAll: 소프트웨어 센터에 표시 및 모든 알림 표시
• DisplaySoftwareCenterOnly: 소프트웨어 센터에 표시하고 컴퓨터 다시 시작에 대한 알림만 표시
• HideAll: 소프트웨어 센터 및 모든 알림에서 숨기기

형식:	UserNotificationType
허용되는 값:	DisplayAll, DisplaySoftwareCenterOnly, HideAll
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-UseSiteDefaultDP

이 매개 변수는 콘솔에서 단계 추가 마법사의 다운로드 설정 페이지에서 다음 설정과 동일합니다. 현재 또는 인접 경계 그룹의 배포 지점에서 소프트웨어 업데이트를 사용할 수 없는 경우 클라이언트는 사이트 기본 경계 그룹의 배포 지점에서 소프트웨어 업데이트를 다운로드하고 설치할 수 있습니다. 다음 값을 지정합니다.

• $true: 사이트 기본 경계 그룹의 배포 지점에서 소프트웨어 업데이트 다운로드 및 설치
• $false: 소프트웨어 업데이트를 설치하지 마세요.

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

-WhatIf

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

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

-WorkstationRestartSuppression

이 매개 변수는 콘솔의 단계 추가 마법사의 사용자 환경 페이지에서 다음 설정과 동일합니다. 워크스테이션 디바이스에서 시스템 다시 시작을 표시하지 않습니다.

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

-WriteFilterCommit

이 매개 변수는 콘솔에서 단계 추가 마법사의 사용자 환경 페이지에서 최종 기한 또는 유지 관리 기간 동안 변경 내용 커밋(다시 시작 필요)의 설정과 동일합니다. 이 설정은 Windows Embedded 디바이스에 대한 쓰기 필터 처리에 적용됩니다.

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

입력

None

출력

Microsoft.ConfigurationManager.PhasedDeploymentModel.Phase