Add-CMDeploymentTypeReturnCode

지원되는 응용 프로그램 배포 유형에 반환 코드를 추가합니다.

Syntax

Add-CMDeploymentTypeReturnCode
   -InputObject <IResultObject>
   -ReturnCode <Int32>
   [-CodeType <ExitCodeClass>]
   [-Name <String>]
   [-Description <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

버전 2107부터 이 cmdlet을 사용하여 지원되는 응용 프로그램 배포 유형에 반환 코드를 추가합니다. 자세한 내용은 배포 유형 반환 코드 를 참조하세요.

참고

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

예제

예제 1: MSI 배포 유형에 반환 코드 1602 추가

이 예제에서는 지정한 응용 프로그램 배포 유형에 반환 1602 코드를 추가합니다.

$appName = "CenterApp"
$dtName = "InterDept - Windows Installer (.msi file)"
$msi_dt = Get-CMDeploymentType -ApplicationName $appName -DeploymentTypeName $dtName

Add-CMDeploymentTypeReturnCode -InputObject $msi_dt -ReturnCode 1602 -Name "User cancel" -CodeType Failure -Description "The user cancelled the installation"

매개 변수

-CodeType

반환 코드의 형식을 지정합니다. 이 설정은 Configuration Manager가 이 배포 유형에서 지정된 반환 코드를 해석하는 방법을 정의합니다. 사용 가능한 유형은 배포 유형 기술에 따라 다릅니다.

  • Failure: 배포 유형을 설치하지 못했습니다.

  • Success: 배포 유형이 성공적으로 설치되었습니다. 재부팅할 필요가 없습니다.

  • FastRetry: 디바이스에서 다른 설치가 이미 진행 중입니다. 클라이언트는 2시간마다 총 10번 다시 검색합니다.

  • HardReboot: 배포 유형이 설치되지만 장치를 다시 시작해야 합니다. 장치가 다시 시작될 때까지 다른 어떤 것도 설치할 수 없습니다.

  • SoftReboot: 배포 유형이 설치되지만 장치를 다시 시작해야 합니다. 다른 설치는 장치를 다시 시작하기 전에 발생할 수 있습니다.

Type:ExitCodeClass
Accepted values:Failure, Success, FastRetry, HardReboot, SoftReboot
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

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

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

-Description

이 반환 코드를 식별하고 설명하는 데 도움이 되는 설명(옵션)을 지정합니다.

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

-DisableWildcardHandling

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

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

-ForceWildcardHandling

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

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

-InputObject

반환 코드를 추가할 배포 유형 개체를 지정합니다. 이 개체를 얻습니다. Get-CMDeploymentType cmdlet을 사용합니다.

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

-Name

이 반환 코드를 설명하는 선택적 이름을 지정합니다.

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

-ReturnCode

이 배포 유형에서 예상되는 반환 코드의 정수 값을 지정합니다. 이 값은 과 의 양수 또는 음수 -2147483648 2147483647 정수입니다.

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

-WhatIf

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

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

입력

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

출력

IResultObject

참고

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