Share via


Set-CMAutoDeploymentRuleDeployment

자동 배포 규칙에 대한 배포를 설정합니다.

Syntax

Set-CMAutoDeploymentRuleDeployment
   [-AlertTime <Int32>]
   [-AlertTimeUnit <TimeUnitType>]
   [-AllowDownloadFromMicrosoftUpdate <Boolean>]
   [-AllowRestart <Boolean>]
   [-AllowSoftwareInstallationOutsideMaintenanceWindow <Boolean>]
   [-AllowUseMeteredNetwork <Boolean>]
   [-AvailableImmediately <Boolean>]
   [-AvailableTime <Int32>]
   [-AvailableTimeUnit <TimeUnitType>]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-DeadlineImmediately <Boolean>]
   [-DeadlineTime <Int32>]
   [-DeadlineTimeUnit <TimeUnitType>]
   [-DisableOperationsManager <Boolean>]
   [-EnableDeployment <Boolean>]
   [-GenerateOperationsManagerAlert <Boolean>]
   [-GenerateSuccessAlert <Boolean>]
   [-InputObject] <IResultObject>
   [-NoInstallOnRemote <Boolean>]
   [-NoInstallOnUnprotected <Boolean>]
   [-PassThru]
   [-RequirePostRebootFullScan <Boolean>]
   [-SendWakeupPacket <Boolean>]
   [-SoftDeadlineEnabled <Boolean>]
   [-SuccessPercentage <Int32>]
   [-SuppressRestartServer <Boolean>]
   [-SuppressRestartWorkstation <Boolean>]
   [-UseBranchCache <Boolean>]
   [-UserNotification <UserNotificationOption>]
   [-UseUtc <Boolean>]
   [-VerboseLevel <VerboseLevelType>]
   [-WriteFilterHandling <Boolean>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMAutoDeploymentRuleDeployment
   [-AlertTime <Int32>]
   [-AlertTimeUnit <TimeUnitType>]
   [-AllowDownloadFromMicrosoftUpdate <Boolean>]
   [-AllowRestart <Boolean>]
   [-AllowSoftwareInstallationOutsideMaintenanceWindow <Boolean>]
   [-AllowUseMeteredNetwork <Boolean>]
   [-AvailableImmediately <Boolean>]
   [-AvailableTime <Int32>]
   [-AvailableTimeUnit <TimeUnitType>]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-DeadlineImmediately <Boolean>]
   [-DeadlineTime <Int32>]
   [-DeadlineTimeUnit <TimeUnitType>]
   [-DisableOperationsManager <Boolean>]
   [-EnableDeployment <Boolean>]
   [-GenerateOperationsManagerAlert <Boolean>]
   [-GenerateSuccessAlert <Boolean>]
   [-Id] <Int32>
   [-NoInstallOnRemote <Boolean>]
   [-NoInstallOnUnprotected <Boolean>]
   [-PassThru]
   [-RequirePostRebootFullScan <Boolean>]
   [-SendWakeupPacket <Boolean>]
   [-SoftDeadlineEnabled <Boolean>]
   [-SuccessPercentage <Int32>]
   [-SuppressRestartServer <Boolean>]
   [-SuppressRestartWorkstation <Boolean>]
   [-UseBranchCache <Boolean>]
   [-UserNotification <UserNotificationOption>]
   [-UseUtc <Boolean>]
   [-VerboseLevel <VerboseLevelType>]
   [-WriteFilterHandling <Boolean>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Set-CMAutoDeploymentRuleDeployment cmdlet은 자동 배포 규칙에 대한 배포를 업데이트합니다.

참고

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

예제

예제 1: ID별로 배포 설정

PS XYZ:\> Set-CMAutoDeploymentRuleDeployment -ID 348 -CollectionName "All Systems" -EnableDeployment $True -SendWakeupPacket $False -VerboseLevel OnlySuccessAndErrorMessages -UseUtc $False  -AvailableTime 7 -AvailableTimeUnit Days -DeadlineTime 7 -DeadlineTimeUnit Days -UserNotification DisplaySoftwareCenterOnly -AllowSoftwareInstallationOutsideMaintenanceWindow $False -AllowRestart $False -SuppressRestartServer  $False -SuppressRestartWorkstation $False -WriteFilterHandling $False -GenerateSuccessAlert $True -SuccessPercentage 10 -AlertTime 7 -AlertTimeUnit Days -DisableOperationsManager $False -GenerateOperationsManagerAlert $False -NoInstallOnRemote $False -NoInstallOnUnprotected $False -UseBranchCache $False

이 명령은 배포 규칙 배포에 대한 설정을 작업 ID 348 및 All Systems라는 컬렉션으로 업데이트합니다.

예제 2: 변수를 사용하여 배포 설정

PS XYZ:\> $ReferenceADR = Get-CMAutoDeploymentRule -Name "TestADR01"
PS XYZ:\> $Deployment = $ReferenceADR | Get-CMAutoDeploymentRuleDeployment
PS XYZ:\> Set-CMAutoDeploymentRuleDeployment -InputObject $Deployment[0] -CollectionName "All Systems" -EnableDeployment $True -SendWakeupPacket $False -VerboseLevel OnlySuccessAndErrorMessages -UseUtc $False -AvailableTime 7 -AvailableTimeUnit Days -DeadlineTime 7 -DeadlineTimeUnit Days -UserNotification DisplaySoftwareCenterOnly -AllowSoftwareInstallationOutsideMaintenanceWindow $False -AllowRestart $False -SuppressRestartServer $False -SuppressRestartWorkstation $False -WriteFilterHandling $False -GenerateSuccessAlert $True -SuccessPercentage 10 -AlertTime 7 -AlertTimeUnit Days -DisableOperationsManager $False -GenerateOperationsManagerAlert $False -NoInstallOnRemote $False -NoInstallOnUnprotected $False -UseBranchCache $False

첫 번째 명령은 TestADR01이라는 자동 배포 규칙 개체를 가져오고 개체를 $ReferenceADR 변수에 저장합니다.

두 번째 명령은 $ReferenceADR 저장된 자동 배포 규칙 개체와 연결된 배포를 가져오고 배포를 $Deployment 변수에 저장합니다.

마지막 명령은 $Deployment 저장된 첫 번째 배포에 대한 설정을 업데이트합니다.

매개 변수

-AlertTime

마감일부터 오프셋에 대한 시간 단위 수를 지정합니다.

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

-AlertTimeUnit

마감일부터 오프셋에 대한 시간 단위 형식을 지정합니다. 유효한 값은 다음과 같습니다.

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

-AllowDownloadFromMicrosoftUpdate

이 매개 변수를 사용하여 ADR 배포 설정의 다운로드 설정 페이지에서 다음 옵션을 설정합니다. 현재, 인접 또는 사이트 경계 그룹의 배포 지점에서 소프트웨어 업데이트를 사용할 수 없는 경우 Microsoft 업데이트 콘텐츠를 다운로드합니다.

Type:Boolean
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

이 매개 변수를 사용하여 ADR 배포 설정의 다운로드 설정 페이지에서 다음 옵션을 설정합니다. 요금제 인터넷 연결의 클라이언트가 설치 기한 이후에 콘텐츠를 다운로드하도록 허용하여 추가 비용이 발생할 수 있습니다.

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 cmdlet을 사용합니다.

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

-CollectionId

소프트웨어 업데이트 배포에 대한 대상 컬렉션의 ID를 지정합니다.

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

-CollectionName

소프트웨어 업데이트 배포에 대한 대상 컬렉션의 이름을 지정합니다.

Type:String
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: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

-DisableOperationsManager

소프트웨어 업데이트가 실행되는 동안 Operations Manager 경고를 사용하지 않도록 설정할지 여부를 나타냅니다.

Type:Boolean
Aliases:DisableOperationManager
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

-EnableDeployment

이 규칙이 연결된 소프트웨어 그룹에 대해 실행된 후 배포를 사용하도록 설정할지 여부를 나타냅니다. $False 설정하면 소프트웨어 업데이트 그룹을 수동으로 배포해야 합니다.

Type:Boolean
Aliases:Enable, EnabledAfterCreate, EnableAfterCreate
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

-GenerateOperationsManagerAlert

소프트웨어 업데이트 설치가 실패할 때 Operations Manager 경고가 생성되는지 여부를 나타냅니다.

Type:Boolean
Aliases:GenerateOperationManagerAlert
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

-Id

자동 배포 규칙 배포의 작업 ID를 지정합니다.

Type:Int32
Aliases:ActionID
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-InputObject

자동 배포 규칙 개체를 지정합니다. 자동 배포 규칙 개체를 가져오려면 Get-CMSoftwareUpdateAutoDeploymentRule cmdlet을 사용합니다.

Type:IResultObject
Aliases:AutoDeploymentRuleDeployment
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-NoInstallOnRemote

원격 배포 지점에서 업데이트를 사용할 수 없는 경우 소프트웨어 업데이트를 설치할지 여부를 나타냅니다.

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

-NoInstallOnUnprotected

보호되지 않는 배포 지점에서 업데이트를 사용할 수 없는 경우 소프트웨어 업데이트를 설치할지 여부를 나타냅니다.

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

-PassThru

작업 중인 항목을 나타내는 개체를 반환하려면 이 매개 변수를 추가합니다. 기본적으로 이 cmdlet은 출력을 생성하지 않을 수 있습니다.

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

-RequirePostRebootFullScan

이 매개 변수를 사용하여 ADR 배포 설정의 사용자 환경 페이지에서 다음 옵션을 설정합니다. 이 배포의 업데이트에 시스템 다시 시작이 필요한 경우 다시 시작한 후 업데이트 배포 평가 주기를 실행합니다.

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

-SendWakeupPacket

Wake-on-LAN을 사용하여 필요한 배포를 위해 클라이언트를 절전 모드 해제할지 여부를 나타냅니다.

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

-SoftDeadlineEnabled

이 매개 변수를 사용하여 ADR 배포 설정의 배포 일정 페이지에서 다음 옵션을 설정합니다. 사용자 기본 설정에 따라 이 배포 적용을 클라이언트 설정에 정의된 유예 기간까지 지연합니다.

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

-SuccessPercentage

클라이언트 규정 준수의 백분율을 정수로 지정합니다. 클라이언트 규정 준수가 이 비율보다 낮으면 경고가 생성됩니다.

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

-UseBranchCache

클라이언트가 동일한 서브넷의 다른 클라이언트와 콘텐츠를 공유할 수 있는지 여부를 나타냅니다.

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

-UserNotification

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

  • DisplayAll
  • DisplaySoftwareCenterOnly
  • HideAll
Type:UserNotificationOption
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

이 규칙에서 만든 배포에 대해 클라이언트가 다시 보고하는 상태 세부 정보를 지정합니다. 유효한 값은 다음과 같습니다.

  • OnlyErrorMessages
  • OnlySuccessAndErrorMessages
  • AllMessages
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

입력

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

출력

IResultObject