Delen via

Set-CMDeploymentTypeReturnCode

  • Artikel

SYNOPSIS

Retourcodes wijzigen voor het opgegeven implementatietype van de toepassing.

SYNTAX

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

DESCRIPTION

Vanaf versie 2107 gebruikt u deze cmdlet om retourcodes te wijzigen voor het opgegeven implementatietype van de toepassing. Zie Retourcodes voor implementatietype voor meer algemene informatie.

Notitie

Voer Configuration Manager cmdlets uit vanaf Configuration Manager sitestation, bijvoorbeeld PS XYZ:\> . Zie Aan de slag voor meer informatie.

EXAMPLES

Voorbeeld 1: het gedrag van de retourcode 3010 wijzigen

In dit voorbeeld wijzigt u het gedrag van de standaard retourcode. Dit is standaard het 3010 type Voor soft reboot. Deze wordt geconfigureerd als hard opstarten en de naam en beschrijving worden gewijzigd.

$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

Geef het type retourcode op. Deze instelling bepaalt hoe Configuration Manager de opgegeven retourcode van dit implementatietype interpreteert. De beschikbare typen variëren op basis van de technologie van het implementatietype.

  • Failure: Het implementatietype kan niet worden geïnstalleerd.

  • Success: het implementatietype is geïnstalleerd en u hoeft niet opnieuw op te starten.

  • FastRetry: Er wordt al een andere installatie uitgevoerd op het apparaat. De client doet elke twee uur opnieuw een nieuwe keer, in totaal tien keer.

  • HardReboot: het implementatietype is geïnstalleerd, maar het apparaat moet opnieuw worden opgestart. Er kan niets anders worden geïnstalleerd totdat het apparaat opnieuw wordt opgestart.

  • SoftReboot: het implementatietype is geïnstalleerd, maar vraagt het apparaat opnieuw op te starten. Andere installaties kunnen plaatsvinden voordat het apparaat opnieuw wordt opgestart.

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

Hiermee wordt u gevraagd om bevestiging voordat u de cmdlet uitvoert.

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

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

-Beschrijving

Geef een optionele beschrijving op om deze retourcode te identificeren en te beschrijven.

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

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

-DisableWildcardHandling

Deze parameter behandelt jokertekens als letterlijke tekenwaarden. U kunt deze niet combineren met ForceWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-ForceWildcardHandling

Deze parameter verwerkt jokertekens en kan leiden tot onverwacht gedrag (niet aanbevolen). U kunt deze niet combineren met DisableWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-InputObject

Geef een implementatietypeobject op waarop de retourcode moet worden gewijzigd. Gebruik de cmdlet Get-CMDeploymentType om dit object op te halen.

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

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

-NewName

Geef een nieuwe naam op om deze retourcode te beschrijven.

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

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

-PassThru

Voeg deze parameter toe om een -object te retourneren dat het item vertegenwoordigt waarmee u werkt. Standaard is het mogelijk dat deze cmdlet geen uitvoer genereert.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-ReturnCode

Geef een geheel getal op voor de retourcode die u verwacht van dit implementatietype. Deze waarde is een positief of negatief geheel getal tussen -2147483648 en 2147483647 .

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

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

-WhatIf

Hiermee wordt weergegeven wat er zou gebeuren als u de cmdlet uitvoert. De cmdlet wordt niet uitgevoerd.

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

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

CommonParameters

Deze cmdlet biedt ondersteuning voor de meest gebruikte parameters: -Debug, - ErrorAction, - ErrorVariable, - InformationAction, -InformationVariable, - OutVariable,-OutBuffer, - PipelineVariable - Verbose, - WarningAction en -WarningVariable. Zie voor meer informatie about_CommonParameters.

INPUTS

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

OUTPUTS

IResultObject#SMS_Application

OPMERKINGEN

Zie WMI-klasse SMS_Application server voor meer informatie over dit retourobject en deeigenschappen ervan.

Add-CMDeploymentTypeReturnCode Get-CMDeploymentTypeReturnCode Remove-CMDeploymentTypeReturnCode

Get-CMDeploymentType