Set-CMDeploymentTypeReturnCode

Referenz

Modul:: ConfigurationManager

Ä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-Standortlaufwerk aus, z. B PS XYZ:\>. . 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.

Typ:	ExitCodeClass
Zulässige Werte:	Failure, Success, FastRetry, HardReboot, SoftReboot
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-Confirm

Fordert Sie vor dem Ausführen des Cmdlets zur Bestätigung auf.

Typ:	SwitchParameter
Aliase:	cf
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-Description

Geben Sie eine optionale Beschreibung an, die Ihnen hilft, diesen Rückgabecode zu identifizieren und zu beschreiben.

Typ:	String
Aliase:	ReturnCodeDescription
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-DisableWildcardHandling

Dieser Parameter behandelt Wildcardzeichen als Literalzeichenwerte. Sie können es nicht mit ForceWildcardHandling kombinieren.

Typ:	SwitchParameter
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-ForceWildcardHandling

Dieser Parameter verarbeitet Wildcardzeichen und kann zu unerwartetem Verhalten führen (nicht empfohlen). Sie können es nicht mit DisableWildcardHandling kombinieren.

Typ:	SwitchParameter
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	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 .

Typ:	IResultObject
Aliase:	DeploymentType
Position:	Named
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	True
Platzhalterzeichen akzeptieren:	False

-NewName

Geben Sie einen neuen Namen an, um diesen Rückgabecode zu beschreiben.

Typ:	String
Aliase:	ReturnCodeName
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	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.

Typ:	SwitchParameter
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	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.

Typ:	Int32
Aliase:	ReturnCodeValue
Position:	Named
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-WhatIf

Zeigt, was passieren würde, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Typ:	SwitchParameter
Aliase:	wi
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	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.

Freigeben über