Set-CMDeploymentTypeReturnCode
Ändern Sie Rückgabecodes für den angegebenen Anwendungsbereitstellungstyp.
Syntax
Set-CMDeploymentTypeReturnCode
-InputObject <IResultObject>
-ReturnCode <Int32>
[-CodeType <ExitCodeClass>]
[-NewName <String>]
[-Description <String>]
[-PassThru]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Beschreibung
Verwenden Sie ab Version 2107 dieses Cmdlet, um Rückgabecodes für den angegebenen Anwendungsbereitstellungstyp zu ändern. Weitere allgemeine Informationen finden Sie unter Rückgabecodes für Bereitstellungstypen.
Hinweis
Führen Sie Configuration Manager Cmdlets auf dem Configuration Manager-Websitelaufwerk aus, z. PS XYZ:\>
B. . Weitere Informationen finden Sie unter Erste Schritte.
Beispiele
Beispiel 1: Ändern des Verhaltens des 3010-Rückgabecodes
In diesem Beispiel wird das Verhalten des Standardrückgabecodes 3010
geändert, bei dem es sich standardmäßig um den Typ "Soft Reboot" handelt. Es konfiguriert sie als harter Neustart und ändert den Namen und die Beschreibung.
$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"
Parameter
-CodeType
Geben Sie den Typ des Rückgabecodes an. Diese Einstellung definiert, wie Configuration Manager den angegebenen Rückgabecode aus diesem Bereitstellungstyp 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
: Auf dem Gerät wird bereits eine weitere Installation ausgeführt. Der Client wiederholt alle zwei Stunden insgesamt 10 Mal.HardReboot
: Der Bereitstellungstyp wurde erfolgreich installiert, erfordert jedoch einen Neustart des Geräts. Bis zum Neustart des Geräts kann nichts anderes installiert werden.SoftReboot
: Der Bereitstellungstyp wurde erfolgreich installiert, fordert jedoch den Neustart des Geräts an. Andere Installationen können vor dem Neustart des Geräts erfolgen.
Type: | ExitCodeClass |
Accepted values: | Failure, Success, FastRetry, HardReboot, SoftReboot |
Position: | Named |
Default value: | None |
Required: | False |
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 |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Description
Geben Sie eine optionale Beschreibung an, die Ihnen hilft, diesen Rückgabecode zu identifizieren und zu beschreiben.
Type: | String |
Aliases: | ReturnCodeDescription |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DisableWildcardHandling
Dieser Parameter behandelt Wildcardzeichen als Literalzeichenwerte. Sie können es nicht mit ForceWildcardHandling kombinieren.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ForceWildcardHandling
Dieser Parameter verarbeitet Wildcardzeichen und kann zu unerwartetem Verhalten führen (nicht empfohlen). Sie können es nicht mit DisableWildcardHandling kombinieren.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InputObject
Geben Sie ein Bereitstellungstypobjekt an, für das der Rückgabecode geändert werden soll. Verwenden Sie zum Abrufen dieses Objekts das Cmdlet Get-CMDeploymentType .
Type: | IResultObject |
Aliases: | DeploymentType |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-NewName
Geben Sie einen neuen Namen an, um diesen Rückgabecode zu beschreiben.
Type: | String |
Aliases: | ReturnCodeName |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PassThru
Fügen Sie diesen Parameter hinzu, um ein Objekt zurückzugeben, das das Element darstellt, mit dem Sie arbeiten. Standardmäßig generiert dieses Cmdlet möglicherweise keine Ausgabe.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
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 |
Required: | True |
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 |
Required: | False |
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 WMI-Serverklasse.
Ähnliche Themen
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für