Set-CMDeploymentTypeReturnCode
SYNOPSIS
Zmodyfikuj kody powrotne dla określonego typu wdrożenia aplikacji.
SYNTAX
Set-CMDeploymentTypeReturnCode -InputObject <IResultObject> -ReturnCode <Int32> [-CodeType <ExitCodeClass>]
[-NewName <String>] [-Description <String>] [-PassThru] [-DisableWildcardHandling] [-ForceWildcardHandling]
[-WhatIf] [-Confirm] [<CommonParameters>]
DESCRIPTION
Począwszy od wersji 2107, użyj tego polecenia cmdlet, aby zmodyfikować kody powrotne dla określonego typu wdrożenia aplikacji. Aby uzyskać więcej ogólnych informacji, zobacz Deployment type Return Codes (Kody powrotne typu wdrożenia).
Uwaga
Uruchom Menedżer konfiguracji cmdlet z dysku Menedżer konfiguracji lokacji, na przykład PS XYZ:\>
. Aby uzyskać więcej informacji, zobacz wprowadzenie.
EXAMPLES
Przykład 1: modyfikowanie zachowania kodu powrotu 3010
W tym przykładzie zmodyfikuje zachowanie domyślnego kodu powrotu, który 3010
jest domyślnie typem ponownego rozruchu programowego. Konfiguruje go jako ponowny rozruch twardy i zmienia nazwę i opis.
$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
Określ typ kodu powrotu. To ustawienie określa, Menedżer konfiguracji interpretować określony kod zwracany z tego typu wdrożenia. Dostępne typy różnią się w zależności od technologii typu wdrożenia.
Failure
: Instalacja typu wdrożenia nie powiodła się.Success
: typ wdrożenia został pomyślnie zainstalowany i nie jest konieczne ponowne uruchomienie.FastRetry
: inna instalacja jest już w toku na urządzeniu. Klient ponownych prób co dwie godziny, łącznie 10 razy.HardReboot
: typ wdrożenia został pomyślnie zainstalowany, ale wymaga ponownego uruchomienia urządzenia. Nic więcej nie można zainstalować do momentu ponownego uruchomienia urządzenia.SoftReboot
: typ wdrożenia został pomyślnie zainstalowany, ale żąda ponownego uruchomienia urządzenia. Inne instalacje mogą wystąpić przed ponownym uruchomieniem urządzenia.
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
Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: cf
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Description (Opis)
Podaj opcjonalny opis, który pomoże Zidentyfikować i opisać ten kod powrotny.
Type: String
Parameter Sets: (All)
Aliases: ReturnCodeDescription
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DisableWildcardHandling
Ten parametr traktuje symbole wieloznaczne jako wartości literału znaków. Nie można połączyć go z forceWildcardHandling.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ForceWildcardHandling
Ten parametr przetwarza symbole wieloznaczne i może prowadzić do nieoczekiwanego zachowania (nie jest zalecane). Nie można połączyć go z disableWildcardHandling.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-InputObject
Określ obiekt typu wdrożenia, na którym ma być modyfikowany kod powrotny. Aby uzyskać ten obiekt, użyj polecenia cmdlet 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
Określ nową nazwę, aby opisać ten kod powrotny.
Type: String
Parameter Sets: (All)
Aliases: ReturnCodeName
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-PassThru
Dodaj ten parametr, aby zwrócić obiekt reprezentujący element, z którym pracujesz. Domyślnie to polecenie cmdlet może nie generować żadnych danych wyjściowych.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ReturnCode
Określ wartość całkowitą dla kodu powrotu, który będzie oczekiwać od tego typu wdrożenia. Ta wartość jest dowolną dodatnią lub ujemną liczbą całkowitą między -2147483648
i 2147483647
.
Type: Int32
Parameter Sets: (All)
Aliases: ReturnCodeValue
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-WhatIf
Pokazuje, co się stanie po uruchomieniu polecenia cmdlet. Polecenie cmdlet nie jest uruchamiane.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: wi
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
Typowe parametry
To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters.
INPUTS
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
OUTPUTS
IResultObject#SMS_Application
UWAGI
Aby uzyskać więcej informacji na temat tego obiektu zwracanego i jego właściwości, zobacz SMS_Application klasy WMI serwera.
RELATED LINKS
Add-CMDeploymentTypeReturnCode Get-CMDeploymentTypeReturnCode Remove-CMDeploymentTypeReturnCode