Dela via


Set-CMDeploymentTypeReturnCode

SYNOPSIS

Ändra returkoder för den angivna programdistributionstypen.

SYNTAX

Set-CMDeploymentTypeReturnCode -InputObject <IResultObject> -ReturnCode <Int32> [-CodeType <ExitCodeClass>]
 [-NewName <String>] [-Description <String>] [-PassThru] [-DisableWildcardHandling] [-ForceWildcardHandling]
 [-WhatIf] [-Confirm] [<CommonParameters>]

DESCRIPTION

Från och med version 2107 använder du denna cmdlet för att ändra returkoder för den angivna programdistributionstypen. Mer allmän information finns i Distributionstypen Returkoder.

Anteckning

Kör Konfigurationshanteraren cmdlets från Konfigurationshanteraren platsenheten, till exempel PS XYZ:\> . Mer information finns i Komma igång.

EXAMPLES

Exempel 1: Ändra beteendet för 3010-returkoden

Det här exemplet ändrar beteendet för 3010 standardreturkoden, som är standardtypen mjuk omstart. Den konfigurerar den som en hård omstart och ändrar namn och beskrivning.

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

PARAMETERS

-CodeType

Ange typ av returkod. Den här inställningen definierar Konfigurationshanteraren tolkar den angivna returkoden från den här distributionstypen. Vilka typer som är tillgängliga varierar beroende på distributionstypstekniken.

  • Failure: Det gick inte att installera distributionstypen.

  • Success: Distributionstypen har installerats och ingen omstart krävs.

  • FastRetry: En annan installation pågår redan på enheten. Klienten försöker på nytt varannan timme, sammanlagt 10 gånger.

  • HardReboot: Distributionstypen har installerats, men kräver att enheten startas om. Inget annat kan installeras förrän enheten startas om.

  • SoftReboot: Distributionstypen har installerats, men begär att enheten startas om. Andra installationer kan ske innan enheten startas om.

Type: ExitCodeClass
Parameter Sets: (All)
Aliases:
Accepted values: Failure, Success, FastRetry, HardReboot, SoftReboot

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

-Confirm

Uppmanar dig att bekräfta innan du kör cmdleten.

Type: SwitchParameter
Parameter Sets: (All)
Aliases: cf

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

-Beskrivning

Ange en valfri beskrivning som hjälper dig att identifiera och beskriva returkoden.

Type: String
Parameter Sets: (All)
Aliases: ReturnCodeDescription

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

-DisableWildcardHandling

Den här parametern behandlar jokertecken som värden för literaltecken. Du kan inte kombinera den med ForceWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-ForceWildcardHandling

Den här parametern bearbetar jokertecken och kan leda till oväntat beteende (rekommenderas inte). Du kan inte kombinera den med DisableWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-InputObject

Ange ett distributionstypobjekt som returkoden ska ändras på. Hämta det här objektet med cmdleten Get-CMDeploymentType.

Type: IResultObject
Parameter Sets: (All)
Aliases: DeploymentType

Required: True
Position: Named
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False

-NewName

Ange ett nytt namn som beskriver returkoden.

Type: String
Parameter Sets: (All)
Aliases: ReturnCodeName

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

-PassThru

Lägg till den här parametern för att returnera ett objekt som representerar det objekt som du arbetar med. Som standard genererar denna cmdlet kanske inte några utdata.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-ReturnCode

Ange ett heltalsvärde för returkoden som du förväntar dig av den här distributionstypen. Det här värdet är ett positivt eller negativt heltal mellan -2147483648 och 2147483647 .

Type: Int32
Parameter Sets: (All)
Aliases: ReturnCodeValue

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-WhatIf

Visar vad som skulle hända om cmdleten kördes. Cmdleten körs inte.

Type: SwitchParameter
Parameter Sets: (All)
Aliases: wi

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

CommonParameters

Denna cmdlet har stöd för parametrarna -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.

INPUTS

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

OUTPUTS

IResultObject#SMS_Application

ANTECKNINGAR

Mer information om det här returobjektet och dess egenskaper finns i SMS_Application serverns WMI-klass.

Add-CMDeploymentTypeReturnCode Get-CMDeploymentTypeReturnCode Remove-CMDeploymentTypeReturnCode

Get-CMDeploymentType