Share via

Set-CMDeploymentTypeReturnCode

  • Referência
Módulo:
ConfigurationManager

Modifique códigos de retorno para o tipo de implantação de aplicativo especificado.

Syntax

Set-CMDeploymentTypeReturnCode
   -InputObject <IResultObject>
   -ReturnCode <Int32>
   [-CodeType <ExitCodeClass>]
   [-NewName <String>]
   [-Description <String>]
   [-PassThru]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

A partir da versão 2107, use este cmdlet para modificar códigos de retorno para o tipo de implantação de aplicativo especificado. Para obter mais informações gerais, confira Código de Retorno do tipo de implantação.

Observação

Execute Configuration Manager cmdlets da unidade do site Configuration Manager, por exemplo PS XYZ:\>. Para obter mais informações, confira introdução.

Exemplos

Exemplo 1: modificar o comportamento do código de retorno 3010

Este exemplo modifica o comportamento do código de retorno padrão 3010 , que é o tipo de Reinicialização Suave por padrão. Ele o configura como uma Reinicialização Dura e altera o nome e a descrição.

$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"

Parâmetros

-CodeType

Especifique o tipo de código de retorno. Essa configuração define como Configuration Manager interpreta o código de retorno especificado desse tipo de implantação. Os tipos disponíveis variam de acordo com a tecnologia de tipo de implantação.

  • Failure: o tipo de implantação não foi instalado.

  • Success: o tipo de implantação foi instalado com êxito e nenhuma reinicialização é necessária.

  • FastRetry: outra instalação já está em andamento no dispositivo. O cliente tenta novamente a cada duas horas, por um total de 10 vezes.

  • HardReboot: o tipo de implantação foi instalado com êxito, mas requer que o dispositivo seja reiniciado. Nada mais pode ser instalado até que o dispositivo seja reiniciado.

  • SoftReboot: o tipo de implantação foi instalado com êxito, mas solicita que o dispositivo seja reiniciado. Outras instalações podem ocorrer antes da reinicialização do dispositivo.

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

Solicita a confirmação antes de executar o cmdlet.

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

-Description

Especifique uma descrição opcional para ajudá-lo a identificar e descrever esse código de retorno.

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

-DisableWildcardHandling

Esse parâmetro trata caracteres curinga como valores de caractere literal. Você não pode combiná-lo com ForceWildcardHandling.

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

-ForceWildcardHandling

Esse parâmetro processa caracteres curinga e pode levar a um comportamento inesperado (não recomendado). Você não pode combiná-lo com DisableWildcardHandling.

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

-InputObject

Especifique um objeto de tipo de implantação no qual modificar o código de retorno. Para obter esse objeto, use o cmdlet Get-CMDeploymentType .

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

-NewName

Especifique um novo nome para descrever esse código de retorno.

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

-PassThru

Adicione esse parâmetro para retornar um objeto que representa o item com o qual você está trabalhando. Por padrão, esse cmdlet pode não gerar nenhuma saída.

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

-ReturnCode

Especifique um valor inteiro para o código de retorno que você espera desse tipo de implantação. Esse valor é qualquer inteiro positivo ou negativo entre -2147483648 e 2147483647.

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

-WhatIf

Mostrar o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

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

Entradas

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Saídas

IResultObject

Observações

Para obter mais informações sobre esse objeto retornado e suas propriedades, consulte SMS_Application classe WMI do servidor.