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.

Get-CMApplication

Get-CMApplicationDeployment

New-CMApplicationDeployment

Remove-CMApplicationDeployment

Wdrażanie aplikacji za pomocą Menedżer konfiguracji