Sdílet prostřednictvím


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:

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.

Get-CMApplication

Get-CMApplicationDeployment

New-CMApplicationDeployment

Remove-CMApplicationDeployment

Nasazení aplikací pomocí Správce konfigurace