Share via

Add-CMDeploymentTypeReturnCode

  • Referência
Módulo:
ConfigurationManager

Adicione códigos de retorno a um tipo de implantação de aplicativo com suporte.

Syntax

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

Description

A partir da versão 2107, use este cmdlet para adicionar códigos de retorno a um tipo de implantação de aplicativo com suporte. Para obter mais informações gerais, consulte Deployment type Return Codes.

Observação

Execute cmdlets do Configuration Manager na unidade de site do Configuration Manager, por PS XYZ:\> exemplo. Para obter mais informações, consulte getting started.

Exemplos

Exemplo 1: Adicionar código de retorno 1602 a um tipo de implantação MSI

Este exemplo adiciona o 1602 código de retorno ao tipo de implantação de aplicativo especificado.

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

Parâmetros

-CodeType

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

  • Failure: Falha na instalação do tipo de implantação.

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

  • FastRetry: Outra instalação já está em andamento no dispositivo. O cliente se recupera a cada duas horas, no total de 10 vezes.

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

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

Type:ExitCodeClass
Accepted values:Failure, Success, FastRetry, HardReboot, SoftReboot
Position:Named
Default value:None
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
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
Accept pipeline input:False
Accept wildcard characters:False

-DisableWildcardHandling

Este parâmetro trata caracteres curinga como valores literais de caracteres. Não é possível combiná-lo com ForceWildcardHandling.

Type:SwitchParameter
Position:Named
Default value:None
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). Não é possível combiná-lo com DisableWildcardHandling.

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

-InputObject

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

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

-Name

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

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

-ReturnCode

Especifique um valor inteiro para o código de retorno esperado deste tipo de implantação. Esse valor é qualquer inteiro positivo ou negativo entre -2147483648 e 2147483647 .

Type:Int32
Aliases:ReturnCodeValue
Position:Named
Default value:None
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
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 de retorno e suas propriedades, consulte SMS_Application classe WMI do servidor.