Set-CMApplicationDeployment
SYNOPSIS
Konfigurowanie wdrożenia aplikacji
SYNTAX
SetApplicationDeploymentByValueMandatory (ustawienie domyślne)
Set-CMApplicationDeployment [-AllowRepairApp <Boolean>] [-AutoCloseExecutable <Boolean>]
[-AvailableDateTime <DateTime>] [-Comment <String>] [-CreateAlertBaseOnPercentFailure <Boolean>]
[-CreateAlertBaseOnPercentSuccess <Boolean>] [-DeadlineDateTime <DateTime>] [-EnableMomAlert <Boolean>]
[-EnableSoftDeadline <Boolean>] [-FailParameterValue <Int32>] -InputObject <IResultObject>
[-OverrideServiceWindow <Boolean>] [-PersistOnWriteFilterDevice <Boolean>] [-PostponeDateTime <DateTime>]
[-PreDeploy <Boolean>] [-RaiseMomAlertsOnFailure <Boolean>] [-RebootOutsideServiceWindow <Boolean>]
[-ReplaceToastNotificationWithDialog <Boolean>] [-RequireApproval <Boolean>] [-SendWakeUpPacket <Boolean>]
[-SuccessParameterValue <Int32>] [-TimeBaseOn <TimeType>] [-UseMeteredNetwork <Boolean>]
[-UserNotification <UserNotificationType>] [-PassThru] [-Collection <IResultObject>] [-CollectionId <String>]
[-CollectionName <String>] [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm]
[<CommonParameters>]
SetApplicationDeploymentByIdMandatory
Set-CMApplicationDeployment [-AllowRepairApp <Boolean>] -ApplicationId <String>
[-AutoCloseExecutable <Boolean>] [-AvailableDateTime <DateTime>] [-Comment <String>]
[-CreateAlertBaseOnPercentFailure <Boolean>] [-CreateAlertBaseOnPercentSuccess <Boolean>]
[-DeadlineDateTime <DateTime>] [-EnableMomAlert <Boolean>] [-EnableSoftDeadline <Boolean>]
[-FailParameterValue <Int32>] [-OverrideServiceWindow <Boolean>] [-PersistOnWriteFilterDevice <Boolean>]
[-PostponeDateTime <DateTime>] [-PreDeploy <Boolean>] [-RaiseMomAlertsOnFailure <Boolean>]
[-RebootOutsideServiceWindow <Boolean>] [-ReplaceToastNotificationWithDialog <Boolean>]
[-RequireApproval <Boolean>] [-SendWakeUpPacket <Boolean>] [-SuccessParameterValue <Int32>]
[-TimeBaseOn <TimeType>] [-UseMeteredNetwork <Boolean>] [-UserNotification <UserNotificationType>] [-PassThru]
[-Collection <IResultObject>] [-CollectionId <String>] [-CollectionName <String>] [-DisableWildcardHandling]
[-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]
SetApplicationDeploymentByNameMandatory
Set-CMApplicationDeployment [-AllowRepairApp <Boolean>] -ApplicationName <String>
[-AutoCloseExecutable <Boolean>] [-AvailableDateTime <DateTime>] [-Comment <String>]
[-CreateAlertBaseOnPercentFailure <Boolean>] [-CreateAlertBaseOnPercentSuccess <Boolean>]
[-DeadlineDateTime <DateTime>] [-EnableMomAlert <Boolean>] [-EnableSoftDeadline <Boolean>]
[-FailParameterValue <Int32>] [-OverrideServiceWindow <Boolean>] [-PersistOnWriteFilterDevice <Boolean>]
[-PostponeDateTime <DateTime>] [-PreDeploy <Boolean>] [-RaiseMomAlertsOnFailure <Boolean>]
[-RebootOutsideServiceWindow <Boolean>] [-ReplaceToastNotificationWithDialog <Boolean>]
[-RequireApproval <Boolean>] [-SendWakeUpPacket <Boolean>] [-SuccessParameterValue <Int32>]
[-TimeBaseOn <TimeType>] [-UseMeteredNetwork <Boolean>] [-UserNotification <UserNotificationType>] [-PassThru]
[-Collection <IResultObject>] [-CollectionId <String>] [-CollectionName <String>] [-DisableWildcardHandling]
[-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]
DESCRIPTION
Polecenie cmdlet Set-CMApplicationDeployment modyfikuje właściwości wdrożenia aplikacji w Menedżer konfiguracji. Aby uzyskać więcej informacji, zobacz Wdrażanie aplikacji za pomocą Menedżer konfiguracji.
Aby określić wdrożenie aplikacji do zmodyfikowania, określ nazwę kolekcji i aplikację. Aplikację można określić według nazwy lub identyfikatora. Aby zmodyfikować aplikację, można również użyć polecenia cmdlet Get-CMApplication.
Uwaga
Uruchom Menedżer konfiguracji cmdlet z Menedżer konfiguracji lokacji, na przykład PS XYZ:\>
. Aby uzyskać więcej informacji, zobacz wprowadzenie.
EXAMPLES
Przykład 1: Modyfikowanie dostępności i terminu wdrożenia aplikacji
Set-CMApplicationDeployment -ApplicationName "Track System 2011" -CollectionName "All Users" -AvailableDateTime (Get-Date) -DeadlineDateTime $(Get-Date).AddDays(30)
To polecenie modyfikuje wdrożenie aplikacji o nazwie Track System 2011 dla kolekcji o nazwie Wszyscy użytkownicy. Polecenie określa bieżącą datę, kiedy aplikacja jest dostępna. Konfiguruje również termin wdrożenia na 30 dni w przyszłości.
PARAMETERS
-AllowRepairApp
Użyj tego parametru, aby skonfigurować opcję naprawy aplikacji podczas tworzenia wdrożenia dla aplikacji.
Type: Boolean
Parameter Sets: (All)
Aliases: AllowUserRepairApplication
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ApplicationId
Określa identyfikator aplikacji.
Type: String
Parameter Sets: SetApplicationDeploymentByIdMandatory
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ApplicationName (Nazwa aplikacji)
Określa nazwę aplikacji.
Type: String
Parameter Sets: SetApplicationDeploymentByNameMandatory
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-AvailableDateTime
Określ obiekt DateTime dla czasu, gdy to wdrożenie jest dostępne. Aby uzyskać ten obiekt, użyj wbudowanego polecenia cmdlet Get-Date.
Użyj wartości DeadlineDateTime, aby określić przypisanie wdrożenia lub termin ostateczny.
Type: DateTime
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Collection (Kolekcja)
Określ obiekt kolekcji, w którym jest wdrażana aplikacja. Aby uzyskać ten obiekt, użyj polecenia cmdlet Get-CMCollection.
Type: IResultObject
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-CollectionId
Określ identyfikator kolekcji, w której wdrożono aplikację. Na przykład "SMS00004"
.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-CollectionName (Nazwa kolekcji)
Określ nazwę kolekcji, w której jest wdrażana aplikacja.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: True
-Komentarz
Określa opcjonalny komentarz dla wdrożenia.
Type: String
Parameter Sets: (All)
Aliases:
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: False
Accept pipeline input: False
Accept wildcard characters: False
-CreateAlertBaseOnPercentFailure
Wskazuje, czy utworzyć alert dla procentu aplikacji, których wdrożenie nie powiodło się. Aby określić wartość procentową, użyj parametru FailParameterValue.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-CreateAlertBaseOnPercentSuccess
Wskazuje, czy utworzyć alert dla procentu aplikacji, które pomyślnie wdrożono. Aby określić wartość procentową, użyj parametru SuccessParameterValue.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DeadlineDateTime
Określ obiekt DateTime dla czasu przypisania tego wdrożenia, nazywany również terminem . Aby uzyskać ten obiekt, użyj wbudowanego polecenia cmdlet Get-Date.
Użyj -AvailableDateTime, aby określić, kiedy wdrożenie jest dostępne.
Type: DateTime
Parameter Sets: (All)
Aliases:
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
-EnableMomAlert
Ustaw ten parametr na $true
wartość , aby System Center Operations Manager tryb konserwacji dla tego wdrożenia.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-EnableSoftDeadline
Ustaw ten parametr na , $true
aby włączyć opóźnione wymuszanie.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-FailParameterValue
Określa wartość procentową nieudanej instalacji aplikacji, która powoduje alert.
Określ liczbę całkowitą z od 1 do 100.
Aby włączyć ten alert, ustaw parametr CreatAlertBaseOnPercentFailure na $True
wartość .
Type: Int32
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 wdrożenia aplikacji do skonfigurowania. Aby uzyskać ten obiekt, użyj polecenia cmdlet Get-CMApplicationDeployment.
Type: IResultObject
Parameter Sets: SetApplicationDeploymentByValueMandatory
Aliases: Application, DeploymentSummary, Assignment
Required: True
Position: Named
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False
-OverrideServiceWindow
Wskazuje, czy wdrożenie ma miejsce, nawet jeśli zostało zaplanowane poza oknem obsługi.
Okno obsługi to określony okres czasu używany do konserwacji i aktualizacji komputera.
Jeśli ta wartość to , program Menedżer konfiguracji aplikację, nawet jeśli zaplanowany czas $True
przypada poza oknem obsługi.
Jeśli ta wartość to , Menedżer konfiguracji aplikacja nie $False
zostanie wdrożona poza oknem. Czeka na wdrożenie w dostępnym oknie.
Type: Boolean
Parameter Sets: (All)
Aliases:
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
-PersistOnWriteFilterDevice
Wskazuje, czy włączyć filtry zapisu dla urządzeń osadzonych.
Dla wartości $True
urządzenie zatwierdza zmiany podczas okna obsługi. Ta akcja wymaga ponownego uruchomienia.
Dla wartości urządzenie zapisuje zmiany w nakładce i $False
zatwierdza je później.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-PostponeDateTime
W przypadku ustawienia parametru CreateAlertBaseOnPercentSuccess na wartość użyj tego parametru, $true
aby określić obiekt DateTime. Menedżer konfiguracji tworzy alert wdrożenia, gdy wartość progowa jest niższa niż wartość SuccessParameterValue po tej dacie.
Aby uzyskać ten obiekt, użyj wbudowanego polecenia cmdlet Get-Date.
Type: DateTime
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-PreDeploy
Wskazuje, czy aplikacja ma zostać wstępnie wdrożona na urządzeniu podstawowym użytkownika.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-RaiseMomAlertsOnFailure
Wskazuje, czy utworzyć alert Operations Manager, jeśli klient nie może zainstalować aplikacji.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-RebootOutsideServiceWindow
Wskazuje, czy komputer jest ponownie uruchamiany poza oknem obsługi.
Okno obsługi to określony okres czasu używany do konserwacji i aktualizacji komputera.
Jeśli ta wartość to $True
, wszelkie wymagane ponowne uruchomienie ma miejsce bez względu na okna obsługi.
Jeśli ta wartość to $False
, komputer nie zostanie uruchomiony ponownie poza oknem obsługi.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ReplaceToastNotificationWithDialog
Jeśli wymagane oprogramowanie jest dostępne na kliencie, ustaw ten parametr na wartość , aby zastąpić domyślne wyskakujące $true
powiadomienia oknem dialogowym. Domyślnie jest to wartość false. Aby uzyskać więcej informacji, zobacz Zastępowanie powiadomień wyskakującego oknem dialogowym.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-RequireApproval
Jeśli ten parametr zostanie ustawiony na wartość , administrator musi zatwierdzić żądanie $true
dla tej aplikacji na urządzeniu.
Type: Boolean
Parameter Sets: (All)
Aliases: AppRequiresApproval
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-SendWakeUpPacket
Wskazuje, czy należy wysłać pakiet wznawiania do komputerów przed rozpoczęciem wdrażania.
Jeśli ta wartość to $True
, Menedżer konfiguracji próbuje wybudzić komputer ze uśpienia.
Jeśli ta wartość to $False
, komputer nie jest wybudzany ze uśpienia.
Aby wznowić wznawianie pracy komputerów, należy najpierw Wake On LAN.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-SuccessParameterValue
Określa wartość procentową pomyślnej instalacji aplikacji, która powoduje alert.
Określ liczbę całkowitą z wartości od 0 do 99.
Aby włączyć ten alert, ustaw parametr CreateAlertBaseOnPercentSuccess na $True
wartość .
Type: Int32
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-TimeBaseOn
Określa strefę czasową do użycia:
LocalTime
: użyj czasu lokalnego.UTC
: użyj Uniwersalny czas koordynowany (UTC).
Type: TimeType
Parameter Sets: (All)
Aliases:
Accepted values: LocalTime, Utc
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-UseMeteredNetwork
Wskazuje, czy zezwalać klientom na pobieranie zawartości za pośrednictwem taryfowego połączenia internetowego po upływie terminu ostatecznego, co może pociągnąć za sobą dodatkowe wydatki.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-UserNotification
Określa typ powiadomienia użytkownika.
DisplayAll
: wyświetlanie w Centrum oprogramowania i wyświetlanie wszystkich powiadomień.DisplaySoftwareCenterOnly
: wyświetlanie w Programie Software Center i wyświetlanie tylko powiadomień o ponownym uruchomieniu komputera.HideAll
: ukryj w Centrum oprogramowania i wszystkie powiadomienia.
Type: UserNotificationType
Parameter Sets: (All)
Aliases:
Accepted values: DisplayAll, DisplaySoftwareCenterOnly, HideAll
Required: False
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: False
Accept pipeline input: False
Accept wildcard characters: False
-AutoCloseExecutable
Począwszy od wersji 2107, ustaw ten parametr na wartość , aby włączyć ustawienie wdrażania aplikacji $true
dla zachowań instalacji. Następnie użyj polecenia cmdlet Add-CMDeploymentTypeInstallBehavior, aby dodać plik wykonywalny do sprawdzenia, czy instalacja nie powiodła się.
Ustaw ten parametr na , $false
aby wyłączyć tę opcję w następujących sytuacjach:
- W przypadku użycia polecenia cmdlet Remove-CMDeploymentTypeInstallBehavior do usunięcia wszystkich plików wykonywalnych
- Nie chcesz, aby wdrożenie sprawdzało, czy są uruchomione pliki wykonywalne.
Type: Boolean
Parameter Sets: (All)
Aliases: AutoCloseExeOnInstallBehavior
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_ApplicationAssignment
UWAGI
Aby uzyskać więcej informacji na temat tego obiektu zwracanego i jego właściwości, zobacz SMS_ApplicationAssignment klasy WMI serwera.