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.
RELATED LINKS
Add-CMDeploymentTypeReturnCode Get-CMDeploymentTypeReturnCode Remove-CMDeploymentTypeReturnCode