Condividi tramite

Set-CMDeploymentTypeReturnCode

  • Riferimento
Modulo:
ConfigurationManager

Modificare i codici restituiti per il tipo di distribuzione dell'applicazione specificato.

Sintassi

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

Descrizione

A partire dalla versione 2107, usare questo cmdlet per modificare i codici restituiti per il tipo di distribuzione dell'applicazione specificato. Per informazioni più generali, vedere Codici restituiti del tipo di distribuzione.

Nota

Eseguire Configuration Manager cmdlet dall'unità del sito Configuration Manager, ad esempio PS XYZ:\>. Per altre informazioni, vedere Introduzione.

Esempio

Esempio 1: Modificare il comportamento del codice restituito 3010

In questo esempio viene modificato il comportamento del codice restituito predefinito 3010 , ovvero il tipo di riavvio software per impostazione predefinita. Lo configura come riavvio rigido e modifica il nome e la descrizione.

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

Parametri

-CodeType

Specificare il tipo di codice restituito. Questa impostazione definisce il modo in cui Configuration Manager interpreta il codice restituito specificato da questo tipo di distribuzione. I tipi disponibili variano in base alla tecnologia dei tipi di distribuzione.

  • Failure: impossibile installare il tipo di distribuzione.

  • Success: il tipo di distribuzione è stato installato correttamente e non è necessario alcun riavvio.

  • FastRetry: un'altra installazione è già in corso nel dispositivo. Il client riprova ogni due ore, per un totale di 10 volte.

  • HardReboot: il tipo di distribuzione è stato installato correttamente, ma richiede il riavvio del dispositivo. Non è possibile installare nient'altro fino al riavvio del dispositivo.

  • SoftReboot: il tipo di distribuzione è stato installato correttamente, ma richiede il riavvio del dispositivo. Altre installazioni possono verificarsi prima del riavvio del dispositivo.

Tipo:ExitCodeClass
Valori accettati:Failure, Success, FastRetry, HardReboot, SoftReboot
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Confirm

Richiede la conferma prima di eseguire il cmdlet.

Tipo:SwitchParameter
Alias:cf
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Description

Specificare una descrizione facoltativa per identificare e descrivere questo codice restituito.

Tipo:String
Alias:ReturnCodeDescription
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-DisableWildcardHandling

Questo parametro considera i caratteri jolly come valori letterali. Non è possibile combinarlo con ForceWildcardHandling.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ForceWildcardHandling

Questo parametro elabora caratteri jolly e può causare un comportamento imprevisto (non consigliato). Non è possibile combinarlo con DisableWildcardHandling.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-InputObject

Specificare un oggetto tipo di distribuzione in cui modificare il codice restituito. Per ottenere questo oggetto, usare il cmdlet Get-CMDeploymentType .

Tipo:IResultObject
Alias:DeploymentType
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-NewName

Specificare un nuovo nome per descrivere questo codice restituito.

Tipo:String
Alias:ReturnCodeName
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-PassThru

Aggiungere questo parametro per restituire un oggetto che rappresenta l'elemento con cui si sta lavorando. Per impostazione predefinita, questo cmdlet potrebbe non generare alcun output.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ReturnCode

Specificare un valore intero per il codice restituito previsto da questo tipo di distribuzione. Questo valore è qualsiasi intero positivo o negativo tra -2147483648 e 2147483647.

Tipo:Int32
Alias:ReturnCodeValue
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-WhatIf

Mostra cosa accade se viene eseguito il cmdlet. Il cmdlet non viene eseguito.

Tipo:SwitchParameter
Alias:wi
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

Input

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Output

IResultObject

Note

Per altre informazioni su questo oggetto restituito e sulle relative proprietà, vedere SMS_Application classe WMI del server.