Share via


New-CMWindowsServicingPlan

Windows 10 서비스 계획을 만듭니다.

Syntax

New-CMWindowsServicingPlan
   -Name <String>
   [-Description <String>]
   -CollectionName <String>
   [-Enable <Boolean>]
   [-SendWakeupPacket <Boolean>]
   [-VerboseLevel <VerboseLevelType>]
   [-Language <String[]>]
   [-Required <String[]>]
   [-Title <String[]>]
   [-RunType <RunType>]
   [-Schedule <IResultObject>]
   [-UseUtc <Boolean>]
   [-AvailableTime <Int32>]
   [-AvailableImmediately <Boolean>]
   [-AvailableTimeUnit <TimeUnitType>]
   [-DeadlineImmediately <Boolean>]
   [-DeadlineTime <Int32>]
   [-DeadlineTimeUnit <TimeUnitType>]
   [-UserNotification <UserNotificationType>]
   [-AllowSoftwareInstallationOutsideMaintenanceWindow <Boolean>]
   [-AllowRestart <Boolean>]
   [-SuppressRestartServer <Boolean>]
   [-SuppressRestartWorkstation <Boolean>]
   [-WriteFilterHandling <Boolean>]
   [-GenerateSuccessAlert <Boolean>]
   [-SuccessPercentage <Int32>]
   [-AlertTime <Int32>]
   [-AlertTimeUnit <TimeUnitType>]
   [-DisableOperationManager <Boolean>]
   [-GenerateOperationManagerAlert <Boolean>]
   [-NoInstallOnRemote <Boolean>]
   [-NoInstallOnUnprotected <Boolean>]
   [-UseBranchCache <Boolean>]
   [-DownloadFromMicrosoftUpdate <Boolean>]
   [-AllowUseMeteredNetwork <Boolean>]
   [-DeploymentPackage <IResultObject>]
   [-DownloadFromInternet <Boolean>]
   [-Location <String>]
   [-DeploymentRing <DeploymentRing>]
   [-UpdateDeploymentWaitDay <Int32>]
   [-LanguageSelection <String[]>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-CMWindowsServicingPlan
   -Name <String>
   [-Description <String>]
   -Collection <IResultObject>
   [-Enable <Boolean>]
   [-SendWakeupPacket <Boolean>]
   [-VerboseLevel <VerboseLevelType>]
   [-Language <String[]>]
   [-Required <String[]>]
   [-Title <String[]>]
   [-RunType <RunType>]
   [-Schedule <IResultObject>]
   [-UseUtc <Boolean>]
   [-AvailableTime <Int32>]
   [-AvailableImmediately <Boolean>]
   [-AvailableTimeUnit <TimeUnitType>]
   [-DeadlineImmediately <Boolean>]
   [-DeadlineTime <Int32>]
   [-DeadlineTimeUnit <TimeUnitType>]
   [-UserNotification <UserNotificationType>]
   [-AllowSoftwareInstallationOutsideMaintenanceWindow <Boolean>]
   [-AllowRestart <Boolean>]
   [-SuppressRestartServer <Boolean>]
   [-SuppressRestartWorkstation <Boolean>]
   [-WriteFilterHandling <Boolean>]
   [-GenerateSuccessAlert <Boolean>]
   [-SuccessPercentage <Int32>]
   [-AlertTime <Int32>]
   [-AlertTimeUnit <TimeUnitType>]
   [-DisableOperationManager <Boolean>]
   [-GenerateOperationManagerAlert <Boolean>]
   [-NoInstallOnRemote <Boolean>]
   [-NoInstallOnUnprotected <Boolean>]
   [-UseBranchCache <Boolean>]
   [-DownloadFromMicrosoftUpdate <Boolean>]
   [-AllowUseMeteredNetwork <Boolean>]
   [-DeploymentPackage <IResultObject>]
   [-DownloadFromInternet <Boolean>]
   [-Location <String>]
   [-DeploymentRing <DeploymentRing>]
   [-UpdateDeploymentWaitDay <Int32>]
   [-LanguageSelection <String[]>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-CMWindowsServicingPlan
   -Name <String>
   [-Description <String>]
   -CollectionId <String>
   [-Enable <Boolean>]
   [-SendWakeupPacket <Boolean>]
   [-VerboseLevel <VerboseLevelType>]
   [-Language <String[]>]
   [-Required <String[]>]
   [-Title <String[]>]
   [-RunType <RunType>]
   [-Schedule <IResultObject>]
   [-UseUtc <Boolean>]
   [-AvailableTime <Int32>]
   [-AvailableImmediately <Boolean>]
   [-AvailableTimeUnit <TimeUnitType>]
   [-DeadlineImmediately <Boolean>]
   [-DeadlineTime <Int32>]
   [-DeadlineTimeUnit <TimeUnitType>]
   [-UserNotification <UserNotificationType>]
   [-AllowSoftwareInstallationOutsideMaintenanceWindow <Boolean>]
   [-AllowRestart <Boolean>]
   [-SuppressRestartServer <Boolean>]
   [-SuppressRestartWorkstation <Boolean>]
   [-WriteFilterHandling <Boolean>]
   [-GenerateSuccessAlert <Boolean>]
   [-SuccessPercentage <Int32>]
   [-AlertTime <Int32>]
   [-AlertTimeUnit <TimeUnitType>]
   [-DisableOperationManager <Boolean>]
   [-GenerateOperationManagerAlert <Boolean>]
   [-NoInstallOnRemote <Boolean>]
   [-NoInstallOnUnprotected <Boolean>]
   [-UseBranchCache <Boolean>]
   [-DownloadFromMicrosoftUpdate <Boolean>]
   [-AllowUseMeteredNetwork <Boolean>]
   [-DeploymentPackage <IResultObject>]
   [-DownloadFromInternet <Boolean>]
   [-Location <String>]
   [-DeploymentRing <DeploymentRing>]
   [-UpdateDeploymentWaitDay <Int32>]
   [-LanguageSelection <String[]>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

New-CMWindowsServicingPlan cmdlet은 Windows 10 서비스 계획을 만듭니다.

참고

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

예제

예제 1: 컬렉션 ID로 서비스 계획 만들기

PS XYZ:\> $Lang = ("Japanese", "English", "French")
PS XYZ:\> $Required = (">=1", "<=100")
PS XYZ:\> $Title = ("Title1", "Title2", "Title3")
PS XYZ:\> New-CMWindowsServicingPlan -Name "Test01" -CollectionId MP40001A -Description "Servicing Plan description01" -SendWakeupPacket $False -VerboseLevel AllMessages -Language $Lang -Required $Required -Title $Title -RunType DoNotRunThisRuleAutomatically -UseUtc $True -AvailableImmediately $True -DeadlineImmediately $False -UserNotification DisplayAll -AllowSoftwareInstallationOutsideMaintenanceWindow $True -AllowRestart $True -SuppressRestartServer $True -SuppressRestartWorkstation $True -DeploymentPackage (Get-CMSoftwareUpdateDeploymentPackage -Name "SUDP01")

첫 번째 명령은 언어 목록을 만들고 목록을 $Lang 변수에 저장합니다.

두 번째 명령은 검색 문자열 목록을 만들고 목록을 $Required 변수에 저장합니다. 이 검색 문자열은 하나 이상의 컴퓨터와 최대 100대 컴퓨터에 필요한 소프트웨어 업데이트를 찾습니다.

세 번째 명령은 소프트웨어 업데이트 타이틀 목록을 만들고 목록을 $Title 변수에 저장합니다.

마지막 명령은 SUDP01이라는 소프트웨어 업데이트 배포 패키지를 가져오고 ID MP40001A를 사용하여 대상 컬렉션에 대한 Test라는 Windows 서비스 계획을 만듭니다. 명령은 $Lang 저장된 업그레이드 필터 언어, $Required 저장된 필수 필터 및 $Title 저장된 소프트웨어 업데이트 타이틀 필터를 추가합니다.

예제 2: 컬렉션 이름으로 서비스 계획 만들기

PS XYZ:\> $LangSelect = ("Japanese", "English", "French", "German")
PS XYZ:\> New-CMWindowsServicingPlan -Name "Test02" -CollectionName "ColName02" -DeploymentPackage (Get-CMSoftwareUpdateDeploymentPackage -Name "SUP02") -WriteFilterHandling $True -GenerateSuccessAlert $True -SuccessPercentage $True -AlertTime 10 -AlertTimeUnit Days -DisableOperationManager $True -GenerateOperationManagerAlert $True -NoInstallOnRemote $True -NoInstallOnUnprotected $True -UseBranchCache $True -DownloadFromMicrosoftUpdate $True -AllowUseMeteredNetwork $True -DownloadFromInternet $True -Location "\\TestSevr\WSUSTemp" -DeploymentRing Cbb -UpdateDeploymentWaitDay 20 -LanguageSelection $LangSelect

첫 번째 명령은 언어 선택 언어 목록을 만들고 목록을 $LangSelect 변수에 저장합니다.

두 번째 명령은 SUP02라는 소프트웨어 업데이트 배포 패키지를 가져오고 ColName02라는 대상 컬렉션에 대해 Test02라는 Windows 서비스 계획을 만듭니다. 명령은 $LangSelect 저장된 언어 선택 언어를 추가합니다.

매개 변수

-AlertTime

업데이트 배포 최종 기한의 정수 오프셋을 지정합니다. 규칙은 이 값을 사용하여 규칙이 경고를 생성하는 시기를 지정합니다. AlertTimeUnit 매개 변수를 사용하여 시간 단위를 지정합니다.

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

-AlertTimeUnit

AlertTime 매개 변수에 대한 시간 단위를 지정합니다. 유효한 값은 다음과 같습니다.

  • 시간
Type:TimeUnitType
Accepted values:Hours, Days, Weeks, Months
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-AllowRestart

설치 최종 기한에 도달할 때 정의된 유지 관리 기간 외부에서 시스템 다시 시작을 수행할 수 있는지 여부를 나타냅니다.

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

-AllowSoftwareInstallationOutsideMaintenanceWindow

설치 기한에 도달할 때 정의된 유지 관리 기간 외부에서 소프트웨어 설치를 수행할 수 있는지 여부를 나타냅니다.

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

-AllowUseMeteredNetwork

최종 기한 이후에 클라이언트가 요금제 인터넷 연결을 통해 콘텐츠를 다운로드할 수 있도록 허용할지 여부를 나타내며, 이로 인해 추가 비용이 발생할 수 있습니다.

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

-AvailableImmediately

규칙을 실행한 후 소프트웨어 업데이트를 가능한 한 빨리 설치할 수 있는지 여부를 나타냅니다.

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

-AvailableTime

소프트웨어 업데이트를 사용할 수 있는 시기를 지정합니다.

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

-AvailableTimeUnit

소프트웨어 사용 가능한 시간에 대한 시간 단위 유형을 지정합니다. 유효한 값은 다음과 같습니다.

  • 시간
Type:TimeUnitType
Accepted values:Hours, Days, Weeks, Months
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Collection

서비스 계획에 사용할 대상 디바이스 컬렉션 개체를 지정합니다. 디바이스 컬렉션 개체를 가져오려면 Get-CMCollection 또는 Get-CMDeviceCollection cmdlet을 사용합니다.

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

-CollectionId

서비스 계획에 사용할 대상 디바이스 컬렉션의 ID를 지정합니다.

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

-CollectionName

서비스 계획에 사용할 대상 디바이스 컬렉션의 이름을 지정합니다.

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

-Confirm

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

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

-DeadlineImmediately

최종 기한에 도달하면 필요한 소프트웨어 업데이트가 가능한 한 빨리 설치되는지 여부를 나타냅니다.

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

-DeadlineTime

최종 기한에 대한 시간 단위 수를 지정합니다.

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

-DeadlineTimeUnit

최종 기한에 대한 시간 단위 유형을 지정합니다. 유효한 값은 다음과 같습니다.

  • 시간
Type:TimeUnitType
Accepted values:Hours, Days, Weeks, Months
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DeploymentPackage

소프트웨어 업데이트 배포 패키지를 지정합니다. 소프트웨어 업데이트 배포 패키지를 가져오려면 Get-CMSoftwareUpdateDeploymentPackage cmdlet을 사용합니다.

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

-DeploymentRing

서비스 계획이 적용되어야 하는 Windows 준비 상태를 지정합니다. 유효한 값은 다음과 같습니다.

  • CB
  • 릴리스
  • BusinessMainstream
  • Cbb
  • Ltsb
Type:DeploymentRing
Accepted values:CB, Release, BusinessMainstream, Cbb, Ltsb
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

-DisableOperationManager

소프트웨어 업데이트 중에 System Center Operations Manager 경고를 사용하지 않도록 설정할지 여부를 나타냅니다.

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

-DownloadFromInternet

인터넷에서 소프트웨어 업데이트를 다운로드할지 여부를 나타냅니다.

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

-DownloadFromMicrosoftUpdate

기본 배포 지점 또는 원격 배포 지점에서 소프트웨어 업데이트를 사용할 수 없는 경우 컴퓨터가 Microsoft 업데이트에서 콘텐츠를 다운로드하는지 여부를 나타냅니다.

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

-Enable

서비스 계획을 사용할 수 있는지 여부를 나타냅니다.

Type:Boolean
Aliases:Enabled, EnableDeployment
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-GenerateOperationManagerAlert

소프트웨어 업데이트 중에 Operations Manager 경고를 생성할지 여부를 나타냅니다.

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

-GenerateSuccessAlert

성공적인 배포에 대한 경고를 생성할지 여부를 나타냅니다.

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

-Language

서비스 계획에 추가될 소프트웨어 업그레이드를 필터링하는 데 사용되는 언어 배열을 지정합니다.

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

-LanguageSelection

언어 배열을 문자열로 지정합니다. 컴퓨터는 비 언어별 업데이트 외에도 지정된 언어로 사용할 수 있는 소프트웨어 업데이트를 다운로드합니다.

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

-Location

다운로드한 업데이트가 있는 네트워크 위치를 지정합니다.

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

-Name

서비스 계획의 이름을 지정합니다. 이름은 고유해야 하며, 규칙의 목적을 설명하고, Configuration Manager 사이트의 다른 사용자로부터 식별할 수 있어야 합니다.

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

-NoInstallOnRemote

원격 시스템에서 업데이트 설치를 허용할지 여부를 나타냅니다. $True 값을 지정하는 경우, 클라이언트가 느리거나 신뢰할 수 없는 네트워크 경계 내에 있거나 클라이언트가 콘텐츠에 대체 원본 위치를 사용하는 경우 Configuration Manager 소프트웨어 업데이트를 설치하지 않습니다. $False 값을 지정하면 설치가 진행됩니다.

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

-NoInstallOnUnprotected

보호되지 않는 시스템에서 업데이트 설치를 허용할지 여부를 나타냅니다. $True 값을 지정하는 경우 기본 배포 지점에서 소프트웨어 업데이트를 사용할 수 없는 경우 Configuration Manager 소프트웨어 업데이트를 다운로드하고 설치하지 않습니다. $False 값을 지정하면 설치가 진행됩니다.

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

-Required

서비스 계획에 추가될 소프트웨어 업그레이드를 필터링하는 데 사용되는 검색 문자열 배열을 지정합니다.

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

-RunType

업데이트가 실행되는 모드를 지정합니다. 유효한 값은 다음과 같습니다.

  • DoNotRunThisRuleAutomatically
  • RunTheRuleAfterAnySoftwareUpdatePointSynchronization
  • RunTheRuleOnSchedule
Type:RunType
Accepted values:DoNotRunThisRuleAutomatically, RunTheRuleAfterAnySoftwareUpdatePointSynchronization, RunTheRuleOnSchedule
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Schedule

최종 기한(배포 사용 가능한 시간)을 지정합니다. 일정을 만들려면 New-CMSchedule cmdlet을 사용합니다.

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

-SendWakeupPacket

배포가 시작되기 전에 컴퓨터에 절전 모드 해제 패킷을 보낼지 여부를 나타냅니다. 이 값이 $True 경우 Configuration Manager 컴퓨터를 절전 모드에서 해제합니다. 이 값이 $False 컴퓨터 절전 모드에서 해제되지 않습니다. 컴퓨터가 절 해제하려면 먼저 Wake On LAN을 구성해야 합니다.

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

-SuccessPercentage

클라이언트 규정 준수에 대한 백분율을 0에서 99까지의 정수로 지정합니다. 규정 준수가 이 비율보다 낮으면 Configuration Manager 선택적 경고를 생성합니다.

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

-SuppressRestartServer

설치 프로세스를 완료하기 위해 소프트웨어 업데이트에서 시스템을 다시 시작해야 하는 경우 서버에서 시스템 다시 시작이 표시되지 않는지 여부를 나타냅니다.

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

-SuppressRestartWorkstation

설치 프로세스를 완료하기 위해 소프트웨어 업데이트에 시스템 다시 시작이 필요한 경우 워크스테이션에서 시스템 다시 시작이 표시되지 않는지 여부를 나타냅니다.

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

-Title

서비스 계획에 추가될 소프트웨어 업데이트 타이틀을 필터링하는 데 사용되는 검색 문자열 배열을 지정합니다.

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

-UpdateDeploymentWaitDay

Microsoft가 사용자 환경에 배포하기 전에 새 업그레이드를 게시한 후 대기할 일 수를 지정합니다.

Type:Int32
Aliases:UpdateDeploymentWaitDays
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-UseBranchCache

분기 캐시를 사용할지 여부를 나타냅니다. $True 값을 지정하면 클라이언트는 동일한 서브넷에서 콘텐츠를 공유합니다.

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

-UserNotification

사용자 시각적 환경의 알림 동작을 지정합니다. 유효한 값은 다음과 같습니다.

  • DisplayAll
  • DisplaySoftwareCenterOnly
  • HideAll
Type:UserNotificationType
Accepted values:DisplayAll, DisplaySoftwareCenterOnly, HideAll
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-UseUtc

이 배포 일정이 UTC(유니버설 조정 시간)에 따라 평가되는지 여부를 나타냅니다.

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

-VerboseLevel

이 규칙이 만드는 배포에 대해 클라이언트가 보고할 세부 정보 수준을 지정합니다. 유효한 값은 다음과 같습니다.

  • AllMessages
  • OnlyErrorMessages
  • OnlySuccessAndErrorMessages
Type:VerboseLevelType
Accepted values:OnlyErrorMessages, OnlySuccessAndErrorMessages, AllMessages
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

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

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

-WriteFilterHandling

변경 내용이 최종 기한에 커밋되는지 또는 유지 관리 기간 동안 커밋되는지 여부를 나타냅니다(다시 시작해야 합니다). $False 설정하면 콘텐츠가 오버레이에 적용되고 나중에 커밋됩니다.

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

입력

None

출력

System.Object