New-CMApplicationDeployment
SYNOPSIS
Tworzenie wdrożenia aplikacji.
SYNTAX
SearchByValueMandatory (ustawienie domyślne)
New-CMApplicationDeployment [-AllowRepairApp <Boolean>] [-ApprovalRequired <Boolean>]
[-AutoCloseExecutable <Boolean>] [-DeadlineDateTime <DateTime>] [-DeployAction <DeployActionType>]
[-DeployPurpose <DeployPurposeType>] [-DisableContentDependencyDetection] [-EnableMomAlert <Boolean>]
[-EnableSoftDeadline <Boolean>] [-FailParameterValue <Int32>] [-GenerateScomAlertOnFailure <Boolean>]
[-InputObject] <IResultObject> [-OverrideServiceWindow <Boolean>] [-PostponeDateTime <DateTime>]
[-PreDeploy <Boolean>] [-RebootOutsideServiceWindow <Boolean>] [-ReplaceToastNotificationWithDialog <Boolean>]
[-Simulation] [-SuccessParameterValue <Int32>] [-TimeBaseOn <TimeType>] [-UpdateSupersedence <Boolean>]
[-UserNotification <UserNotificationType>] [-DistributeCollectionName <String>] [-DistributeContent]
[-DistributionPointGroupName <String>] [-DistributionPointName <String>] [-AvailableDateTime <DateTime>]
[-Comment <String>] [-PersistOnWriteFilterDevice <Boolean>] [-SendWakeupPacket <Boolean>]
[-UseMeteredNetwork <Boolean>] [-Collection <IResultObject>] [-CollectionId <String>]
[-CollectionName <String>] [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm]
[<CommonParameters>]
SearchByIdMandatory
New-CMApplicationDeployment [-AllowRepairApp <Boolean>] [-ApprovalRequired <Boolean>]
[-AutoCloseExecutable <Boolean>] [-DeadlineDateTime <DateTime>] [-DeployAction <DeployActionType>]
[-DeployPurpose <DeployPurposeType>] [-DisableContentDependencyDetection] [-EnableMomAlert <Boolean>]
[-EnableSoftDeadline <Boolean>] [-FailParameterValue <Int32>] [-GenerateScomAlertOnFailure <Boolean>]
[-Id] <Int32> [-OverrideServiceWindow <Boolean>] [-PostponeDateTime <DateTime>] [-PreDeploy <Boolean>]
[-RebootOutsideServiceWindow <Boolean>] [-ReplaceToastNotificationWithDialog <Boolean>] [-Simulation]
[-SuccessParameterValue <Int32>] [-TimeBaseOn <TimeType>] [-UpdateSupersedence <Boolean>]
[-UserNotification <UserNotificationType>] [-DistributeCollectionName <String>] [-DistributeContent]
[-DistributionPointGroupName <String>] [-DistributionPointName <String>] [-AvailableDateTime <DateTime>]
[-Comment <String>] [-PersistOnWriteFilterDevice <Boolean>] [-SendWakeupPacket <Boolean>]
[-UseMeteredNetwork <Boolean>] [-Collection <IResultObject>] [-CollectionId <String>]
[-CollectionName <String>] [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm]
[<CommonParameters>]
SearchByNameMandatory
New-CMApplicationDeployment [-AllowRepairApp <Boolean>] [-ApprovalRequired <Boolean>]
[-AutoCloseExecutable <Boolean>] [-DeadlineDateTime <DateTime>] [-DeployAction <DeployActionType>]
[-DeployPurpose <DeployPurposeType>] [-DisableContentDependencyDetection] [-EnableMomAlert <Boolean>]
[-EnableSoftDeadline <Boolean>] [-FailParameterValue <Int32>] [-GenerateScomAlertOnFailure <Boolean>]
[-Name] <String> [-OverrideServiceWindow <Boolean>] [-PostponeDateTime <DateTime>] [-PreDeploy <Boolean>]
[-RebootOutsideServiceWindow <Boolean>] [-ReplaceToastNotificationWithDialog <Boolean>] [-Simulation]
[-SuccessParameterValue <Int32>] [-TimeBaseOn <TimeType>] [-UpdateSupersedence <Boolean>]
[-UserNotification <UserNotificationType>] [-DistributeCollectionName <String>] [-DistributeContent]
[-DistributionPointGroupName <String>] [-DistributionPointName <String>] [-AvailableDateTime <DateTime>]
[-Comment <String>] [-PersistOnWriteFilterDevice <Boolean>] [-SendWakeupPacket <Boolean>]
[-UseMeteredNetwork <Boolean>] [-Collection <IResultObject>] [-CollectionId <String>]
[-CollectionName <String>] [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm]
[<CommonParameters>]
DESCRIPTION
Polecenie cmdlet New-CMApplicationDeployment tworzy wdrożenie aplikacji. Aby uzyskać więcej informacji, zobacz Wdrażanie aplikacji za pomocą Menedżer konfiguracji.
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: instalowanie aplikacji
To polecenie tworzy nowe wdrożenie dla programu Visual Studio 2019 w kolekcji Developers Workstation. Instaluje ona aplikację i jest wymagana. Zarówno dostępna data, jak i termin ostateczny są takie same jak w przeszłości, więc zaraz po otrzymaniu tych zasad klient zainstaluje aplikację.
New-CMApplicationDeployment -Name "Visual Studio 2019" -AvailableDateTime '01/01/2020 00:00:00' -CollectionName 'Developers Workstation' -DeadlineDateTime '01/01/2020 00:00:00' -DeployAction Install -DeployPurpose Required
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
-ApprovalRequired
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
-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 funkcji 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 ta aplikacja jest wdrażana. 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
Określ nazwę kolekcji, w której ta aplikacja jest wdrażana.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: True
-Komentarz
Określ opcjonalny komentarz dla tego 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: 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: SupersedenceDeadlineDateTime
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DeployAction
Określ akcję wdrażania, aby zainstalować lub odinstalować aplikację. Jeśli konkurencyjne wdrożenia są ukierunkowane na to samo urządzenie, akcja Zainstaluj ma priorytet.
Type: DeployActionType
Parameter Sets: (All)
Aliases:
Accepted values: Install, Uninstall
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DeployPurpose
Określ cel wdrożenia:
Available: użytkownik widzi aplikację w Centrum oprogramowania. Mogą go zainstalować na żądanie.Required: klient automatycznie instaluje aplikację zgodnie z ustawionym harmonogramem. Jeśli aplikacja nie jest ukryta, użytkownik może śledzić stan wdrożenia. Mogą również zainstalować aplikację przed upływem terminu ostatecznego za pomocą Centrum oprogramowania.
Type: DeployPurposeType
Parameter Sets: (All)
Aliases:
Accepted values: Available, Required
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DisableContentDependencyDetection
Dodaj ten parametr, aby nie dystrybuować automatycznie zawartości dla aplikacji zależnych.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: DisableDetectAssociatedContentDependencies
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
-DistributeCollectionName
Lokacja dystrybuuje zawartość do punktów dystrybucji skojarzonych z tą nazwą kolekcji.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DistributeContent
Dodaj ten parametr, jeśli musisz najpierw dystrybuować zawartość aplikacji.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DistributionPointGroupName
Aby dystrybuować zawartość aplikacji, określ nazwę grupy punktów dystrybucji.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DistributionPointName
Aby dystrybuować zawartość aplikacji, określ nazwę punktu dystrybucji.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-EnableMomAlert
Ustaw ten parametr na wartość $true , 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 wartości 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
-GenerateScomAlertOnFailure
Wskazuje, czy utworzyć alert Operations Manager, jeśli klient nie może zainstalować aplikacji.
Type: Boolean
Parameter Sets: (All)
Aliases: RaiseMomAlertsOnFailure
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Id (Identyfikator)
Określ identyfikator aplikacji do wdrożenia.
Type: Int32
Parameter Sets: SearchByIdMandatory
Aliases: CIId, CI_ID, ApplicationId
Required: True
Position: 0
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-InputObject
Określ obiekt aplikacji do wdrożenia. Aby uzyskać ten obiekt, użyj polecenia cmdlet Get-CMApplication.
Type: IResultObject
Parameter Sets: SearchByValueMandatory
Aliases: Application
Required: True
Position: 0
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False
-Name
Określ nazwę aplikacji do wdrożenia.
Type: String
Parameter Sets: SearchByNameMandatory
Aliases: LocalizedDisplayName, ApplicationName
Required: True
Position: 0
Default value: None
Accept pipeline input: False
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 na konserwację i aktualizacje komputera.
Jeśli ta wartość to , 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 zostanie $False wdrożona poza oknem. Oczekuje 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
-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.
W przypadku 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
-RebootOutsideServiceWindow
Wskazuje, czy komputer jest ponownie uruchamiany poza oknem obsługi.
Okno obsługi to określony okres czasu używany na konserwację i aktualizacje 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 $true wyskakujące 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
-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
-Symulacja
Dodaj ten parametr, aby utworzyć symulację wdrożenia. Aby uzyskać więcej informacji, zobacz Symulowanie wdrożeń aplikacji za pomocą Menedżer konfiguracji.
Type: SwitchParameter
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
-UpdateSupersedence
W przypadku dostępnego wdrożenia użyj tego parametru, aby określić ostateczny termin instalacji w celu uaktualnienia użytkowników lub urządzeń, na których zainstalowano przesłonną aplikację. Użyj funkcji DeadlineDateTime, aby określić określoną wartość czasu. W przeciwnym razie jest to możliwe jak najszybciej po wartości AvailableDateTime.
Type: Boolean
Parameter Sets: (All)
Aliases:
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: None
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.