Add-CMDeploymentTypeReturnCode
Fügen Sie Einem unterstützten Anwendungsbereitstellungstyp Rückgabecodes hinzu.
Syntax
Add-CMDeploymentTypeReturnCode
-InputObject <IResultObject>
-ReturnCode <Int32>
[-CodeType <ExitCodeClass>]
[-Name <String>]
[-Description <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Beschreibung
Verwenden Sie ab Version 2107 dieses Cmdlet, um einem unterstützten Anwendungsbereitstellungstyp Rückgabecodes hinzuzufügen. Weitere allgemeine Informationen finden Sie unter Rückgabecodes für bereitstellungstyp.
Hinweis
Führen Sie Configuration Manager-Cmdlets beispielsweise vom Configuration Manager-Standortlaufwerk PS XYZ:\> aus. Weitere Informationen finden Sie unter "Erste Schritte".
Beispiele
Beispiel 1: Hinzufügen des Rückgabecodes 1602 zu einem MSI-Bereitstellungstyp
In diesem Beispiel wird dem 1602 angegebenen Anwendungsbereitstellungstyp der Rückgabecode hinzugefügt.
$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"Parameter
-CodeType
Geben Sie den Typ des Rückgabecodes an. Diese Einstellung definiert, wie Configuration Manager den angegebenen Rückgabecode dieses Bereitstellungstyps interpretiert. Die verfügbaren Typen variieren je nach Bereitstellungstyptechnologie.
Failure: Der Bereitstellungstyp konnte nicht installiert werden.Success: Der Bereitstellungstyp wurde erfolgreich installiert, und es ist kein Neustart erforderlich.FastRetry: Eine weitere Installation auf dem Gerät wird bereits ausgeführt. Der Client wiederholt den Vorgang alle zwei Stunden, insgesamt 10 Mal.HardReboot: Der Bereitstellungstyp wurde erfolgreich installiert, erfordert jedoch einen Neustart des Geräts. Es kann nichts anderes installiert werden, bis das Gerät neu gestartet wird.SoftReboot: Der Bereitstellungstyp wurde erfolgreich installiert, fordert jedoch den Neustart des Geräts an. Andere Installationen können auftreten, bevor das Gerät neu gestartet wird.
| Type: | ExitCodeClass |
| Accepted values: | Failure, Success, FastRetry, HardReboot, SoftReboot |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Confirm
Fordert Sie vor dem Ausführen des Cmdlets zur Bestätigung auf.
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Description
Geben Sie eine optionale Beschreibung an, mit der Sie diesen Rückgabecode identifizieren und beschreiben können.
| Type: | String |
| Aliases: | ReturnCodeDescription |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DisableWildcardHandling
Dieser Parameter behandelt Platzhalterzeichen als Literalzeichenwerte. Sie können es nicht mit ForceWildcardHandlingkombinieren.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ForceWildcardHandling
Dieser Parameter verarbeitet Platzhalterzeichen und kann zu unerwartetem Verhalten führen (nicht empfohlen). Sie können es nicht mit DisableWildcardHandlingkombinieren.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-InputObject
Geben Sie ein Bereitstellungstypobjekt an, dem der Rückgabecode hinzugefügt werden soll. Verwenden Sie zum Abrufen dieses Objekts das Cmdlet "Get-CMDeploymentType".
| Type: | IResultObject |
| Aliases: | DeploymentType |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Name
Geben Sie einen optionalen Namen an, um diesen Rückgabecode zu beschreiben.
| Type: | String |
| Aliases: | ReturnCodeName |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ReturnCode
Geben Sie einen ganzzahligen Wert für den Rückgabecode an, den Sie von diesem Bereitstellungstyp erwarten. Dieser Wert ist eine beliebige positive oder negative ganze Zahl zwischen -2147483648 und 2147483647 .
| Type: | Int32 |
| Aliases: | ReturnCodeValue |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-WhatIf
Zeigt, was passieren würde, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Eingaben
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
Ausgaben
IResultObject
Hinweise
Weitere Informationen zu diesem Rückgabeobjekt und seinen Eigenschaften finden Sie unter SMS_Application Server-WMI-Klasse.