Partager via

Add-CMDeploymentTypeReturnCode

  • Référence
Module:
ConfigurationManager

Ajoutez des codes de retour à un type de déploiement d’application pris en charge.

Syntax

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

Description

À compter de la version 2107, utilisez cette cmdlet pour ajouter des codes de retour à un type de déploiement d’application pris en charge. Pour plus d’informations générales, voir Deployment type Return Codes.

Notes

Exécutez les cmdlets Configuration Manager à partir du lecteur de site Configuration Manager, par PS XYZ:\> exemple. Pour plus d’informations, voir la mise en place.

Exemples

Exemple 1 : Ajouter le code de retour 1602 à un type de déploiement MSI

Cet exemple ajoute le 1602 code de retour au type de déploiement d’application spécifié.

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

Paramètres

- Confirmer

Une invite de confirmation apparaît avant d’exécuter le cmdlet.

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

- WhatIf

Présente ce qui se produit si le cmdlet s’exécute. La cmdlet ne s’exécute pas.

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

-CodeType

Spécifiez le type de code de retour. Ce paramètre définit comment Configuration Manager interprète le code de retour spécifié à partir de ce type de déploiement. Les types disponibles varient en fonction de la technologie de type de déploiement.

  • Failure: Le type de déploiement n’a pas réussi à s’installer.

  • Success: Le type de déploiement a été correctement installé et aucun redémarrage n’est nécessaire.

  • FastRetry: une autre installation est déjà en cours sur l’appareil. Le client ressesserre toutes les deux heures, pour un total de 10 fois.

  • HardReboot: Le type de déploiement a été correctement installé, mais nécessite le redémarrage de l’appareil. Rien d’autre ne peut être installé tant que l’appareil n’a pas redémarré.

  • SoftReboot: Le type de déploiement a été correctement installé, mais demande à l’appareil de redémarrer. D’autres installations peuvent se produire avant le redémarrage de l’appareil.

Type:ExitCodeClass
Accepted values:Failure, Success, FastRetry, HardReboot, SoftReboot
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-Description

Spécifiez une description facultative pour vous aider à identifier et décrire ce code de retour.

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

-DisableWildcardHandling

Ce paramètre traite les caractères génériques comme des valeurs littérales. Vous ne pouvez pas la combiner avec ForceWildcardHandling.

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

-ForceWildcardHandling

Ce paramètre traite les caractères génériques et peut entraîner un comportement inattendu (non recommandé). Vous ne pouvez pas la combiner avec DisableWildcardHandling.

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

-InputObject

Spécifiez un objet de type de déploiement sur lequel ajouter le code de retour. Pour obtenir cet objet, utilisez la cmdlet Get-CMDeploymentType.

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

-Name

Spécifiez un nom facultatif pour décrire ce code de retour.

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

-ReturnCode

Spécifiez une valeur de type integer pour le code de retour que vous attendez de ce type de déploiement. Cette valeur est n’importe quel integer positif ou négatif entre -2147483648 et 2147483647 .

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

Entrées

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Sorties

IResultObject

Notes

Pour plus d’informations sur cet objet de retour et ses propriétés, voir SMS_Application classe WMI du serveur.