Compartilhar via

Set-CMDeploymentTypeReturnCode

  • Referência
Módulo:
ConfigurationManager

Modifique os códigos de retorno para o tipo de implementação de aplicação especificado.

Sintaxe

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, utilize este cmdlet para modificar os códigos de retorno para o tipo de implementação de aplicação especificado. Para obter informações mais gerais, veja Códigos de Retorno do tipo de implementação.

Observação

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

Exemplos

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

Este exemplo modifica o comportamento do código de retorno predefinido 3010 , que é o tipo de Reinício Recuperável por predefinição. Configura-o como um Reinício Rígido 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. Esta definição define como o Configuration Manager interpreta o código de retorno especificado deste tipo de implementação. Os tipos disponíveis variam com base na tecnologia do tipo de implementação.

  • Failure: Falha ao instalar o tipo de implementação.

  • Success: o tipo de implementação foi instalado com êxito e não é necessário reiniciar.

  • FastRetry: Já existe outra instalação em curso no dispositivo. O cliente volta a tentar de duas em duas horas, num total de 10 vezes.

  • HardReboot: o tipo de implementação foi instalado com êxito, mas requer que o dispositivo seja reiniciado. Não é possível instalar mais nada até que o dispositivo reinicie.

  • SoftReboot: o tipo de implementação foi instalado com êxito, mas pede ao dispositivo para reiniciar. Outras instalações podem ocorrer antes de o dispositivo reiniciar.

Tipo:ExitCodeClass
Valores aceitos:Failure, Success, FastRetry, HardReboot, SoftReboot
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Confirm

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

Tipo:SwitchParameter
Aliases:cf
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Description

Especifique uma descrição opcional para o ajudar a identificar e descrever este código de retorno.

Tipo:String
Aliases:ReturnCodeDescription
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DisableWildcardHandling

Este parâmetro trata os carateres universais como valores de carateres literais. Não pode combiná-lo com ForceWildcardHandling.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ForceWildcardHandling

Este parâmetro processa carateres universais e pode levar a um comportamento inesperado (não recomendado). Não pode combiná-lo com DisableWildcardHandling.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-InputObject

Especifique um objeto de tipo de implementação no qual pretende modificar o código de retorno. Para obter este objeto, utilize o cmdlet Get-CMDeploymentType .

Tipo:IResultObject
Aliases:DeploymentType
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-NewName

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

Tipo:String
Aliases:ReturnCodeName
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-PassThru

Adicione este parâmetro para devolver um objeto que representa o item com o qual está a trabalhar. Por predefinição, este cmdlet pode não gerar qualquer saída.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ReturnCode

Especifique um valor inteiro para o código de retorno esperado deste tipo de implementação. Este valor é qualquer número inteiro positivo ou negativo entre -2147483648 e 2147483647.

Tipo:Int32
Aliases:ReturnCodeValue
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-WhatIf

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

Tipo:SwitchParameter
Aliases:wi
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

Entradas

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Saídas

IResultObject

Observações

Para obter mais informações sobre este objeto de retorno e as respetivas propriedades, veja SMS_Application classe WMI de servidor.