Set-CMDeploymentTypeReturnCode
지정된 애플리케이션 배포 유형에 대한 반환 코드를 수정합니다.
Syntax
Set-CMDeploymentTypeReturnCode
-InputObject <IResultObject>
-ReturnCode <Int32>
[-CodeType <ExitCodeClass>]
[-NewName <String>]
[-Description <String>]
[-PassThru]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
버전 2107부터 이 cmdlet을 사용하여 지정된 애플리케이션 배포 유형에 대한 반환 코드를 수정합니다. 자세한 내용은 배포 유형 반환 코드를 참조하세요.
참고
Configuration Manager 사이트 드라이브에서 Configuration Manager cmdlet을 실행합니다(예: PS XYZ:\>
). 자세한 내용은 시작을 참조하세요.
예제
예제 1: 3010 반환 코드의 동작 수정
이 예제에서는 기본적으로 소프트 다시 부팅 형식인 기본 3010
반환 코드의 동작을 수정합니다. 하드 다시 부팅으로 구성하고 이름과 설명을 변경합니다.
$appName = "CenterApp"
$dtName = "InterDept - Windows Installer (.msi file)"
$msi_dt = Get-CMDeploymentType -ApplicationName $appName -DeploymentTypeName $dtName
Add-CMDeploymentTypeReturnCode -InputObject $msi_dt -ReturnCode 3010 -Name "Always reboot" -CodeType HardReboot -Description "Change soft reboot to hard reboot"
매개 변수
-CodeType
반환 코드의 형식을 지정합니다. 이 설정은 Configuration Manager 이 배포 유형에서 지정된 반환 코드를 해석하는 방법을 정의합니다. 사용 가능한 형식은 배포 유형 기술에 따라 달라집니다.
Failure
: 배포 유형을 설치하지 못했습니다.Success
: 배포 유형이 성공적으로 설치되었으며 다시 부팅할 필요가 없습니다.FastRetry
: 디바이스에서 다른 설치가 이미 진행 중입니다. 클라이언트는 2시간마다 총 10회 재시도합니다.HardReboot
: 배포 유형이 성공적으로 설치되었지만 디바이스를 다시 시작해야 합니다. 디바이스가 다시 시작될 때까지 다른 어떤 것도 설치할 수 없습니다.SoftReboot
: 배포 유형이 성공적으로 설치되었지만 디바이스를 다시 시작하도록 요청합니다. 디바이스를 다시 시작하기 전에 다른 설치가 발생할 수 있습니다.
Type: | ExitCodeClass |
Accepted values: | Failure, Success, FastRetry, HardReboot, SoftReboot |
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 |
-Description
이 반환 코드를 식별하고 설명하는 데 도움이 되는 선택적 설명을 지정합니다.
Type: | String |
Aliases: | ReturnCodeDescription |
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 |
-InputObject
반환 코드를 수정할 배포 유형 개체를 지정합니다. 이 개체를 얻으려면 Get-CMDeploymentType cmdlet을 사용합니다.
Type: | IResultObject |
Aliases: | DeploymentType |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-NewName
이 반환 코드를 설명할 새 이름을 지정합니다.
Type: | String |
Aliases: | ReturnCodeName |
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 |
-ReturnCode
이 배포 유형에서 예상하는 반환 코드의 정수 값을 지정합니다. 이 값은 및 사이의 -2147483648
양수 또는 음수 정수입니다 2147483647
.
Type: | Int32 |
Aliases: | ReturnCodeValue |
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 |
입력
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
출력
IResultObject
참고
이 반환 개체 및 해당 속성에 대한 자세한 내용은 SMS_Application 서버 WMI 클래스를 참조하세요.
관련 링크
피드백
https://aka.ms/ContentUserFeedback
출시 예정: 2024년 내내 콘텐츠에 대한 피드백 메커니즘으로 GitHub 문제를 단계적으로 폐지하고 이를 새로운 피드백 시스템으로 바꿀 예정입니다. 자세한 내용은 다음을 참조하세요.다음에 대한 사용자 의견 제출 및 보기