Nuta
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować się zalogować lub zmienić katalog.
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować zmienić katalogi.
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.