New-CMApplicationDeployment
SYNOPSIS
Vytvořte nasazení aplikace.
SYNTAX
SearchByValueMandatory (výchozí)
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
Rutina New-CMApplicationDeployment vytvoří nasazení aplikace. Další informace najdete v tématu nasazení aplikací pomocí Configuration Manager.
Poznámka
Použijte například rutiny Configuration Manager z Configuration Manager jednotky webu PS XYZ:\> . Další informace najdete v tématu Začínáme.
EXAMPLES
Příklad 1: instalace aplikace
tento příkaz vytvoří nové nasazení pro Visual Studio 2019 do pracovní stanice vývojářů kolekce. Nainstaluje aplikaci a vyžaduje se. Dostupné datum i konečný termín jsou v minulosti stejný čas, takže jakmile klient obdrží tuto zásadu, nainstaluje aplikaci.
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
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
-ApprovalRequired
Pokud nastavíte tento parametr na $true , správce musí na zařízení schválit žádost o tuto aplikaci.
Type: Boolean
Parameter Sets: (All)
Aliases: AppRequiresApproval
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-AvailableDateTime
Zadejte objekt data a času , pro který je toto nasazení k dispozici. K získání tohoto objektu použijte vestavěnou rutinu Get-Date .
Pomocí DeadlineDateTime určete přiřazení nasazení nebo konečný termín.
Type: DateTime
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
– Kolekce
Zadejte 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 tato aplikace nasazena. 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é je tato aplikace nasazena.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: True
– Komentář
Zadejte volitelný komentář pro toto 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: None
Accept pipeline input: False
Accept wildcard characters: False
-DeadlineDateTime
Zadejte objekt DateTime , který se má použít při přiřazení tohoto nasazení, označovaný také jako konečný termín. K získání tohoto objektu použijte vestavěnou rutinu Get-Date .
Pomocí -AvailableDateTime určete, kdy je nasazení k dispozici.
Type: DateTime
Parameter Sets: (All)
Aliases: SupersedenceDeadlineDateTime
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DeployAction
Určete akci nasazení, buď k instalaci nebo odinstalaci aplikace. Pokud konkurenční nasazení cílí na stejné zařízení, má akce instalovat prioritu.
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
Zadejte účel nasazení:
Available: Uživatel uvidí aplikaci v centru softwaru. Můžou ho instalovat na vyžádání.Required: Klient automaticky nainstaluje aplikaci podle plánu, který jste nastavili. Pokud aplikace není skrytá, může uživatel sledovat jeho stav nasazení. Můžou také pomocí centra softwaru instalovat aplikaci před konečným termínem.
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
Tento parametr přidejte, pokud nechcete automaticky distribuovat obsah pro závislé aplikace.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: DisableDetectAssociatedContentDependencies
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DisableWildcardHandling
Tento parametr považuje zástupné znaky jako literálové hodnoty znaků. Nejde kombinovat s ForceWildcardHandling.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DistributeCollectionName
Lokalita distribuuje obsah do distribučních bodů, které jsou přidruženy k tomuto názvu kolekce.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DistributeContent
Pokud potřebujete nejprve distribuovat obsah aplikace, přidejte tento parametr.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DistributionPointGroupName
Chcete-li distribuovat obsah aplikace, zadejte název skupiny distribučních bodů.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DistributionPointName
Chcete-li distribuovat obsah aplikace, zadejte název distribučního bodu.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-EnableMomAlert
nastavením tohoto parametru $true povolíte System Center Operations Manager režim ú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
Nastavením tohoto parametru na $true povolíte zpožděné vynucení.
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ůsobila výstrahu.
Zadejte celé číslo od 1 do 100.
Chcete-li povolit tuto výstrahu, nastavte parametr CreatAlertBaseOnPercentFailure na hodnotu $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čujeme). Nejde kombinovat s DisableWildcardHandling.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-GenerateScomAlertOnFailure
Určuje, zda se má vytvořit výstraha Operations Manager, pokud se klientovi nepovede nainstalovat aplikaci.
Type: Boolean
Parameter Sets: (All)
Aliases: RaiseMomAlertsOnFailure
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
– ID
Zadejte ID aplikace, která se má nasadit.
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
– Položky InputObject
Zadejte objekt aplikace, který chcete nasadit. K získání tohoto objektu použijte rutinu 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
Zadejte název aplikace, která se má nasadit.
Type: String
Parameter Sets: SearchByNameMandatory
Aliases: LocalizedDisplayName, ApplicationName
Required: True
Position: 0
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-OverrideServiceWindow
Určuje, zda nasazení probíhá i v případě, že je naplánováno mimo časové období údržby.
Časový interval pro správu a údržbu je určený časový úsek, který se používá pro údržbu a aktualizace počítačů.
Pokud je tato hodnota $True , Configuration Manager nasadí aplikaci i v případě, že naplánovaný čas spadá mimo časový interval pro správu a údržbu.
Pokud je tato hodnota $False , Configuration Manager aplikaci nesadí mimo okno. Počká, dokud nebude možné ho nasadit 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
-PersistOnWriteFilterDevice
Určuje, jestli se mají povolit filtry zápisu pro vložená zařízení.
V případě hodnoty $True se zařízení během údržby potvrdí. Tato akce vyžaduje restart.
V případě hodnoty $False se zařízení uloží změny v překrytí a později se potvrdí.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-PostponeDateTime
Při nastavování CreateAlertBaseOnPercentSuccess na $true použijte tento parametr k určení objektu DateTime . Configuration Manager vytvoří výstrahu pro nasazení, když je prahová hodnota nižší než SuccessParameterValue po tomto datu.
K získání tohoto objektu použijte vestavěnou rutinu Get-Date .
Type: DateTime
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
– Předběžné nasazení
Označ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
-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
-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
-Simulation (Simulace)
Přidáním tohoto parametru vytvoříte simulaci nasazení. Další informace najdete v tématu Simulace nasazení aplikací pomocí Správce konfigurace.
Type: SwitchParameter
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
-UpdateSupersedence
Pro dostupné nasazení použijte tento parametr k určení konečného termínu instalace pro upgrade uživatelů nebo zařízení, ve které je nainstalovaná nahlášená aplikace. K určení konkrétního času použijte DeadlineDateTime, jinak je to co nejdříve po vlastnosti AvailableDateTime.
Type: Boolean
Parameter Sets: (All)
Aliases:
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: None
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.