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-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.