Set-CMApplicationDeployment
SYNOPSIS
Konfigurace nasazení aplikace
SYNTAX
SetApplicationDeploymentByValueMandatory (výchozí)
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
Rutina Set-CMApplicationDeployment upravuje vlastnosti nasazení aplikace v Správce konfigurace. Další informace najdete v tématu Nasazení aplikací pomocí Správce konfigurace.
Pokud chcete určit nasazení aplikace, které chcete upravit, zadejte název kolekce a aplikaci. Aplikaci můžete zadat podle názvu nebo ID. K získání aplikace, kterou chcete upravit, můžete také použít rutinu Get-CMApplication.
Poznámka
Spusťte Správce konfigurace rutiny z Správce konfigurace lokality, například PS XYZ:\>
. Další informace najdete v tématu Začínáme.
EXAMPLES
Příklad 1: Úprava dostupnosti a konečného termínu pro nasazení aplikace
Set-CMApplicationDeployment -ApplicationName "Track System 2011" -CollectionName "All Users" -AvailableDateTime (Get-Date) -DeadlineDateTime $(Get-Date).AddDays(30)
Tento příkaz upraví nasazení aplikace pro aplikaci s názvem Sledovat systém 2011 pro kolekci s názvem Všichni uživatelé. Příkaz určuje aktuální datum, kdy je aplikace dostupná. Také nakonfiguruje konečný termín nasazení na 30 dní v budoucnosti.
PARAMETERS
-AllowRepairApp
Tento parametr použijte ke konfiguraci možnosti opravné aplikace při vytváření nasazení pro aplikaci.
Type: Boolean
Parameter Sets: (All)
Aliases: AllowUserRepairApplication
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ApplicationId
Určuje ID aplikace.
Type: String
Parameter Sets: SetApplicationDeploymentByIdMandatory
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ApplicationName
Určuje název aplikace.
Type: String
Parameter Sets: SetApplicationDeploymentByNameMandatory
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-AvailableDateTime
Zadejte objekt DateTime pro , pokud je toto nasazení k dispozici. K získání tohoto objektu použijte integrovanou rutinu Get-Date.
K určení přiřazení nasazení nebo termínu použijte DeadlineDateTime.
Type: DateTime
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Collection
Určete objekt kolekce, do kterého je aplikace nasazena. K získání tohoto objektu použijte rutinu Get-CMCollection.
Type: IResultObject
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-CollectionId
Zadejte ID kolekce, do které je aplikace nasazená. Například, "SMS00004"
.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-CollectionName
Zadejte název kolekce, do které se aplikace nasadí.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: True
-Comment
Určuje volitelný komentář pro nasazení.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Confirm
Před spuštěním rutiny zobrazí výzvu k potvrzení.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: cf
Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
-CreateAlertBaseOnPercentFailure
Určuje, jestli se má vytvořit výstraha pro procento aplikací, které se nedaří nasadit. Pokud chcete zadat procentuální hodnotu, použijte parametr FailParameterValue.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-CreateAlertBaseOnPercentSuccess
Určuje, jestli se má vytvořit výstraha pro procento úspěšně nasazených aplikací. Pokud chcete zadat procentuální hodnotu, použijte parametr SuccessParameterValue.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DeadlineDateTime
Zadejte objekt DateTime pro při přiřazení tohoto nasazení, označované také jako termín. K získání tohoto objektu použijte integrovanou rutinu Get-Date.
Pomocí možnosti -AvailableDateTime určete, kdy je nasazení k dispozici.
Type: DateTime
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DisableWildcardHandling
Tento parametr považuje zástupné znaky za hodnoty literálových znaků. Nemůžete ho kombinovat s forceWildcardHandling.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-EnableMomAlert
Tento parametr nastavte $true
na , pokud System Center Operations Manager režimu údržby pro toto nasazení.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-EnableSoftDeadline
Pokud chcete povolit $true
zpožděné vynucení, nastavte tento parametr na .
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-FailParameterValue
Určuje procento neúspěšné instalace aplikace, která způsobuje výstrahu.
Zadejte celé číslo od 1 do 100.
Pokud chcete tuto výstrahu povolit, nastavte parametr CreatAlertBaseOnPercentFailure na $True
.
Type: Int32
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ForceWildcardHandling
Tento parametr zpracovává zástupné znaky a může vést k neočekávanému chování (nedoporučuje se). Nemůžete ho kombinovat s příkazem DisableWildcardHandling.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-InputObject
Určete objekt nasazení aplikace, který chcete nakonfigurovat. K získání tohoto objektu použijte rutinu 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
Určuje, jestli nasazení probíhá i v případě, že je naplánované mimo interval údržby.
Časové období údržby je určené časové období, které se používá k údržbě a aktualizacím počítače.
Pokud je tato hodnota , Správce konfigurace aplikace i v případě, že naplánovaný $True
čas spadá mimo časové období údržby.
Pokud je tato $False
hodnota , Správce konfigurace nenasadí aplikaci mimo okno. Počká na nasazení v dostupném okně.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-PassThru
Přidáním tohoto parametru vrátíte objekt, který představuje položku, se kterou pracujete. Ve výchozím nastavení tato rutina nemusí generovat žádný výstup.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-PersistOnWriteFilterDevice
Určuje, jestli se mají povolit filtry zápisu pro vložená zařízení.
V případě hodnoty $True
se zařízení potvrdí během okna údržby. Tato akce vyžaduje restartování.
Pro hodnotu uloží zařízení změny $False
do překrytí a potvrdí je později.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-PostponeDateTime
Když nastavíte CreateAlertBaseOnPercentSuccess na , použijte tento parametr $true
k určení objektu DateTime. Správce konfigurace po tomto datu vytvoří výstrahu nasazení, pokud je prahová hodnota nižší než hodnota SuccessParameterValue.
K získání tohoto objektu použijte integrovanou rutinu Get-Date.
Type: DateTime
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-PreDeploy
Určuje, jestli se má aplikace předem nasadit na primární zařízení uživatele.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-RaiseMomAlertsOnFailure
Určuje, jestli se má vytvořit Operations Manager, pokud se klientovi nepodaří nainstalovat aplikaci.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-RebootOutsideServiceWindow
Určuje, jestli se počítač restartuje mimo okno údržby.
Časové období údržby je určené časové období, které se používá k údržbě a aktualizacím počítače.
Pokud je tato hodnota $True
, dojde k požadovaného restartování bez ohledu na časová období údržby.
Pokud je tato hodnota $False
, počítač se nerestartuje mimo okno údržby.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ReplaceToastNotificationWithDialog
Pokud je v klientovi k dispozici požadovaný software, nastavte tento parametr na , aby se výchozí informační zprávy nahradily $true
dialogem. Ve výchozím nastavení je to false. Další informace najdete v tématu Nahrazení informačních zpráv dialogem.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-RequireApproval
Pokud tento parametr nastavíte na , musí správce schválit žádost $true
o tuto aplikaci na zařízení.
Type: Boolean
Parameter Sets: (All)
Aliases: AppRequiresApproval
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-SendWakeUpPacket
Určuje, jestli se má odeslat paket pro probuzení do počítačů před zahájením nasazení.
Pokud je tato hodnota $True
, Správce konfigurace pokusí probuzení počítače z režimu spánku.
Pokud je tato hodnota $False
, neprobudí počítače z režimu spánku.
Aby se počítače probuzení, musíte nejprve nakonfigurovat 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
Určuje procento úspěšné instalace aplikace, která způsobuje výstrahu.
Zadejte celé číslo od 0 do 99.
Pokud chcete tuto výstrahu povolit, nastavte parametr CreateAlertBaseOnPercentSuccess na $True
hodnotu .
Type: Int32
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-TimeBaseOn
Určuje, které časové pásmo se má použít:
LocalTime
: Použijte místní čas.UTC
: Použijte koordinovaný univerzální čas (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
Určuje, jestli se má klientům povolit stahování obsahu přes měřené připojení k internetu po uplynutí konečného termínu, což může být náklady navíc.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-UserNotification
Určuje typ oznámení uživatele.
DisplayAll
: Zobrazí se v Centru softwaru a zobrazí všechna oznámení.DisplaySoftwareCenterOnly
: Zobrazí se v Centru softwaru a zobrazí jenom oznámení o restartování počítače.HideAll
: Skrýt v Centru softwaru a všechna oznámení.
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
Zobrazuje, co by se stalo při spuštění rutiny. Rutina se nespouštěl.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: wi
Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
-AutoCloseExecutable
Počínaje verzí 2107 nastavte tento parametr na , abyste umožnili nastavení nasazení aplikace $true
pro chování instalace. Potom pomocí rutiny Add-CMDeploymentTypeInstallBehavior přidejte spustitelný soubor, který chcete zkontrolovat, že instalace není spuštěná, aby byla úspěšná.
Nastavte tento parametr na , pokud chcete tuto možnost zakázat $false
v následujících situacích:
- Když k odebrání všech spustitelných souborů použijete rutinu Remove-CMDeploymentTypeInstallBehavior
- Nechcete, aby nasazení kontroluje spuštěné spustitelné soubory.
Type: Boolean
Parameter Sets: (All)
Aliases: AutoCloseExeOnInstallBehavior
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
CommonParameters
Tato rutina podporuje společné parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction a -WarningVariable. Další informace najdete v tématu about_CommonParameters.
INPUTS
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
OUTPUTS
IResultObject#SMS_ApplicationAssignment
POZNÁMKY
Další informace o tomto návratového objektu a jeho vlastnostech najdete v SMS_ApplicationAssignment rozhraní WMI.