Add-CMDeploymentTypeReturnCode
Agregue códigos devueltos a un tipo de implementación de aplicación compatible.
Syntax
Add-CMDeploymentTypeReturnCode
-InputObject <IResultObject>
-ReturnCode <Int32>
[-CodeType <ExitCodeClass>]
[-Name <String>]
[-Description <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
A partir de la versión 2107, use este cmdlet para agregar códigos devueltos a un tipo de implementación de aplicación compatible. Para obtener más información general, vea Deployment type Return Codes.
Nota
Ejecute los cmdlets de Configuration Manager desde la unidad de sitio de Configuration Manager, por ejemplo PS XYZ:\>
. Para obtener más información, vea getting started.
Ejemplos
Ejemplo 1: Agregar código devuelto 1602 a un tipo de implementación MSI
En este ejemplo se agrega 1602
el código devuelto al tipo de implementación de aplicación 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
- Confirm
Solicitará confirmación antes de ejecutar el cmdlet.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CodeType
Especifique el tipo de código devuelto. Esta configuración define cómo Configuration Manager interpreta el código de devolución especificado de este tipo de implementación. Los tipos disponibles varían en función de la tecnología de tipo de implementación.
Failure
: no se pudo instalar el tipo de implementación.Success
: el tipo de implementación se instaló correctamente y no es necesario reiniciar.FastRetry
: Ya hay otra instalación en curso en el dispositivo. El cliente vuelve a reintentos cada dos horas, para un total de 10 veces.HardReboot
: el tipo de implementación se instaló correctamente, pero requiere que el dispositivo se reinicie. No se puede instalar nada más hasta que se reinicie el dispositivo.SoftReboot
: el tipo de implementación se instaló correctamente, pero solicita que se reinicie el dispositivo. Pueden producirse otras instalaciones antes de que se reinicie el dispositivo.
Type: | ExitCodeClass |
Accepted values: | Failure, Success, FastRetry, HardReboot, SoftReboot |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Description
Especifique una descripción opcional que le ayude a identificar y describir este código devuelto.
Type: | String |
Aliases: | ReturnCodeDescription |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DisableWildcardHandling
Este parámetro trata los caracteres comodín como valores de caracteres literales. No se puede combinar con ForceWildcardHandling.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ForceWildcardHandling
Este parámetro procesa caracteres comodín y puede provocar un comportamiento inesperado (no recomendado). No se puede combinar con DisableWildcardHandling.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InputObject
Especifique un objeto de tipo de implementación en el que agregar el código devuelto. Para obtener este objeto, use el cmdlet Get-CMDeploymentType.
Type: | IResultObject |
Aliases: | DeploymentType |
Position: | Named |
Default value: | None |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Name
Especifique un nombre opcional para describir este código devuelto.
Type: | String |
Aliases: | ReturnCodeName |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ReturnCode
Especifique un valor entero para el código devuelto que espera de este tipo de implementación. Este valor es cualquier entero positivo o negativo entre -2147483648
y 2147483647
.
Type: | Int32 |
Aliases: | ReturnCodeValue |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
Muestra lo que ocurriría si se ejecuta el cmdlet. El cmdlet no se ejecuta.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Entradas
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
Salidas
IResultObject
Notas
Para obtener más información sobre este objeto devuelto y sus propiedades, vea SMS_Application server WMI class.