Set-CMDeploymentTypeReturnCode
SYNOPSIS
Modifique os códigos de devolução para o tipo de implementação de aplicação 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, utilize este cmdlet para modificar códigos de devolução para o tipo de implementação de aplicação especificado. Para obter informações mais gerais, consulte códigos de devolução do tipo de implementação.
Nota
Executar cmdlets do Gestor de Configuração a partir da unidade do site do Gestor de Configuração, por exemplo PS XYZ:\>
. Para mais informações, consulte a partida.
EXAMPLES
Exemplo 1: Modificar o comportamento do código de devolução 3010
Este exemplo modifica o comportamento do código de devolução predefinido, 3010
que é o tipo Soft Reboot por padrão. Configura-o como um Hard Reboot 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"
PARAMETERS
-CodeType
Especifique o tipo de código de devolução. Esta definição define como o Gestor de Configuração interpreta o código de devolução especificado a partir deste tipo de implementação. Os tipos disponíveis variam em função da tecnologia do tipo de implantação.
Failure
: O tipo de implantação não foi instalado.Success
: O tipo de implantação instalado com sucesso e não é necessário reiniciar.FastRetry
: Já está em curso outra instalação no aparelho. O cliente recauchutado a cada duas horas, num total de 10 vezes.HardReboot
: O tipo de implantação instalou-se com sucesso, mas requer que o dispositivo reinicie. Nada mais pode ser instalado até que o dispositivo reinicie.SoftReboot
: O tipo de implantação instalou-se com sucesso, mas solicita que o dispositivo reinicie. Podem ocorrer outras instalações antes do recomeçamento do dispositivo.
Type: ExitCodeClass
Parameter Sets: (All)
Aliases:
Accepted values: Failure, Success, FastRetry, HardReboot, SoftReboot
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Confirm
Solicita a sua confirmação antes de executar o cmdlet.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: cf
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Descrição
Especifique uma descrição opcional para ajudá-lo a identificar e descrever este código de devolução.
Type: String
Parameter Sets: (All)
Aliases: ReturnCodeDescription
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DisableWildcardHandling
Este parâmetro trata os caracteres wildcard como valores de caracteres literais. Não pode combiná-lo com ForceWildcardHandling.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ForceWildcardHandling
Este parâmetro processa caracteres wildcard e pode levar a um comportamento inesperado (não recomendado). Não é possível combiná-lo com DisableWildcardHandling.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-InputObject
Especifique um objeto tipo de implantação para modificar o código de devolução. Para obter este objeto, utilize o cmdlet Get-CMDeploymentType.
Type: IResultObject
Parameter Sets: (All)
Aliases: DeploymentType
Required: True
Position: Named
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False
-Novo Nome
Especifique um novo nome para descrever este código de devolução.
Type: String
Parameter Sets: (All)
Aliases: ReturnCodeName
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
- PassThru
Adicione este parâmetro para devolver um objeto que represente o item com o qual está a trabalhar. Por predefinição, este cmdlet pode não gerar qualquer saída.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Código de Retorno
Especifique um valor inteiro para o código de devolução que espera deste tipo de implementação. Este valor é qualquer número inteiro positivo ou negativo entre -2147483648
e 2147483647
.
Type: Int32
Parameter Sets: (All)
Aliases: ReturnCodeValue
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
- O QueIf
Apresenta o que aconteceria mediante a execução do cmdlet. O comandante não funciona.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: wi
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
CommonParameters
Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction e -WarningVariable. Para mais informações, consulte about_CommonParameters.
INPUTS
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
OUTPUTS
IResultObject#SMS_Application
NOTAS
Para obter mais informações sobre este objeto de retorno e suas propriedades, consulte SMS_Application classe WMI do servidor.
RELATED LINKS
Add-CMDeploymentTypeReturnCode Get-CMDeploymentTypeReturnCode Remover-CMDeploymentTypeReturnCode