New-CMApplicationDeployment
SYNOPSIS
Maak een toepassingsimplementatie.
SYNTAX
SearchByValueMandatory (standaard)
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
Met de cmdlet New-CMApplicationDeployment wordt een toepassingsimplementatie gemaakt. Zie Deploy applications with Configuration Manager (Toepassingen implementeren met Configuration Manager) voor meer informatie.
Notitie
Voer Configuration Manager cmdlets uit vanaf Configuration Manager sitestation, bijvoorbeeld PS XYZ:\> . Zie Aan de slag voor meer informatie.
EXAMPLES
Voorbeeld 1: Een toepassing installeren
Met deze opdracht maakt u een nieuwe implementatie voor Visual Studio 2019 naar de verzameling Developers Workstation. De app wordt geïnstalleerd en is vereist. Zowel de beschikbare datum als de deadline liggen op hetzelfde tijdstip in het verleden, dus zodra de client dit beleid ontvangt, wordt de app geïnstalleerd.
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
Gebruik deze parameter om de optie hersteltoepassing te configureren bij het maken van een implementatie voor een toepassing.
Type: Boolean
Parameter Sets: (All)
Aliases: AllowUserRepairApplication
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ApprovalRequired
Als u deze parameter in stelt op $true , moet een beheerder een aanvraag voor deze toepassing op het apparaat goedkeuren.
Type: Boolean
Parameter Sets: (All)
Aliases: AppRequiresApproval
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-AvailableDateTime
Geef een DateTime-object op voor wanneer deze implementatie beschikbaar is. Gebruik de ingebouwde cmdlet Get-Date om dit object op te halen.
Gebruik DeadlineDateTime om de implementatietoewijzing of deadline op te geven.
Type: DateTime
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Collection
Geef een verzamelingsobject op waarop de toepassing wordt geïmplementeerd. Gebruik de cmdlet Get-CMCollection om dit object op te halen.
Type: IResultObject
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-CollectionId
Geef de id op van de verzameling waarop deze toepassing is geïmplementeerd. Bijvoorbeeld "SMS00004".
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-CollectionName
Geef de naam op van de verzameling waarop deze toepassing is geïmplementeerd.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: True
-Opmerking
Geef een optionele opmerking op voor deze implementatie.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Confirm
Hiermee wordt u gevraagd om bevestiging voordat u de cmdlet uitvoert.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: cf
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DeadlineDateTime
Geef een DateTime-object op voor wanneer deze implementatie wordt toegewezen, ook wel bekend als de deadline. Gebruik de ingebouwde cmdlet Get-Date om dit object op te halen.
Gebruik -AvailableDateTime om op te geven wanneer de implementatie beschikbaar is.
Type: DateTime
Parameter Sets: (All)
Aliases: SupersedenceDeadlineDateTime
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DeployAction
Geef de implementatieactie op om de toepassing te installeren of te verwijderen. Als concurrerende implementaties op hetzelfde apparaat zijn gericht, heeft de installatieactie prioriteit.
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
Geef het implementatiedoel op:
Available: De gebruiker ziet de toepassing in Software Center. Ze kunnen deze op aanvraag installeren.Required: De client installeert de app automatisch volgens het schema dat u hebt ingesteld. Als de toepassing niet verborgen is, kan een gebruiker de implementatiestatus bijhouden. Ze kunnen Software Center ook gebruiken om de toepassing vóór de deadline te installeren.
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
Voeg deze parameter toe om niet automatisch inhoud voor afhankelijke apps te distribueren.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: DisableDetectAssociatedContentDependencies
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DisableWildcardHandling
Deze parameter behandelt jokertekens als letterlijke tekenwaarden. U kunt deze niet combineren met ForceWildcardHandling.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DistributeCollectionName
De site distribueert inhoud naar de distributiepunten die zijn gekoppeld aan deze verzamelingsnaam.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DistributeContent
Voeg deze parameter toe als u eerst de app-inhoud moet distribueren.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DistributionPointGroupName
Geef de naam van een distributiepuntgroep op om de toepassingsinhoud te distribueren.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DistributionPointName
Geef de naam van een distributiepunt op om de toepassingsinhoud te distribueren.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-EnableMomAlert
Stel deze parameter in op $true om de onderhoudsmodus System Center Operations Manager in te schakelen voor deze implementatie.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-EnableSoftDeadline
Stel deze parameter in op $true om vertraagde afdwinging in te stellen.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-FailParameterValue
Hiermee geeft u het percentage mislukte toepassingsinstallatie op dat een waarschuwing veroorzaakt.
Geef een geheel getal tussen 1 en 100 op.
Als u deze waarschuwing wilt inschakelen, stelt u de parameter CreatAlertBaseOnPercentFailure in op $True .
Type: Int32
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ForceWildcardHandling
Deze parameter verwerkt jokertekens en kan leiden tot onverwacht gedrag (niet aanbevolen). U kunt deze niet combineren met DisableWildcardHandling.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-GeneratescomAlertOnFailure
Geeft aan of er een waarschuwing moet Operations Manager als een client de toepassing niet kan installeren.
Type: Boolean
Parameter Sets: (All)
Aliases: RaiseMomAlertsOnFailure
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Id
Geef de id op van de toepassing die moet worden geïmplementeerd.
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
Geef een toepassingsobject op dat moet worden geïmplementeerd. Gebruik de cmdlet Get-CMApplication om dit object op te halen.
Type: IResultObject
Parameter Sets: SearchByValueMandatory
Aliases: Application
Required: True
Position: 0
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False
-Name
Geef de naam op van de toepassing die u wilt implementeren.
Type: String
Parameter Sets: SearchByNameMandatory
Aliases: LocalizedDisplayName, ApplicationName
Required: True
Position: 0
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-OverrideServiceWindow
Geeft aan of de implementatie plaatsvindt, zelfs als deze buiten een onderhoudsvenster is gepland.
Een onderhoudsvenster is een opgegeven periode die wordt gebruikt voor computeronderhoud en updates.
Als deze waarde is, Configuration Manager de toepassing zelfs als de geplande tijd $True buiten het onderhoudsvenster valt.
Als deze waarde $False is, Configuration Manager de toepassing niet buiten het venster geïmplementeerd. Het wacht totdat het kan worden geïmplementeerd in een beschikbaar venster.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-PersistOnWriteFilterDevice
Geeft aan of schrijffilters voor ingesloten apparaten moeten worden ingeschakeld.
Voor de waarde $True , worden wijzigingen doorgevoerd tijdens een onderhoudsvenster. Voor deze actie moet opnieuw worden opgestart.
Voor de waarde $False slaat het apparaat wijzigingen op in een overlay en worden deze later doorgevoerd.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-PostponeDateTime
Wanneer u CreateAlertBaseOnPercentSuccess in stelt op , gebruikt u deze $true parameter om een DateTime-object op te geven. Configuration Manager maakt een implementatiewaarschuwing wanneer de drempelwaarde lager is dan de SuccessParameterValue na deze datum.
Gebruik de ingebouwde cmdlet Get-Date om dit object op te halen.
Type: DateTime
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-PreDeploy
Geeft aan of de toepassing vooraf moet worden geïmplementeerd op het primaire apparaat van de gebruiker.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-RebootOutsideServiceWindow
Geeft aan of een computer opnieuw wordt opgestart buiten een onderhoudsvenster.
Een onderhoudsvenster is een opgegeven periode die wordt gebruikt voor computeronderhoud en updates.
Als deze waarde $True is, vindt vereist opnieuw opstarten plaats zonder rekening te houden met onderhoudsvensters.
Als deze waarde $False is, wordt de computer niet opnieuw opgestart buiten een onderhoudsvenster.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ReplaceToastNotificationWithDialog
Als de vereiste software beschikbaar is op de client, stelt u deze parameter in op om de standaard $true pop-upmeldingen te vervangen door een dialoogvenster. Deze is standaard onwaar. Zie Pop-upmeldingen vervangen door dialoogvenster voor meer informatie.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-SendWakeupPacket
Geeft aan of een ontwaagpakket naar computers moet worden verzenden voordat de implementatie begint.
Als deze waarde $True is, Configuration Manager probeert een computer uit de slaapstand te ontwaken.
Als deze waarde $False is, worden computers niet uit de slaapstand lapt.
Als u computers wilt laten ontwaken, moet u eerst de Wake On LAN.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Simulatie
Voeg deze parameter toe om een implementatiesimulatie te maken. Zie Toepassingsimplementaties simuleren metConfiguration Manager voor meer Configuration Manager.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-SuccessParameterValue
Hiermee geeft u het percentage geslaagde toepassingsinstallatie op dat een waarschuwing veroorzaakt.
Geef een geheel getal tussen 0 en 99 op.
Als u deze waarschuwing wilt inschakelen, stelt u de parameter CreateAlertBaseOnPercentSuccess in op $True .
Type: Int32
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-TimeBaseOn
Hiermee geeft u op welke tijdzone moet worden gebruikt:
LocalTime: Lokale tijd gebruiken.UTC: gebruik Coordinated Universal Time (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
Voor een beschikbare implementatie gebruikt u deze parameter om de installatiedeadline op te geven voor het upgraden van gebruikers of apparaten waarin de toepassing is geïnstalleerd. Gebruik DeadlineDateTime om een specifiek tijdstip op te geven, anders wordt het zo snel mogelijk na AvailableDateTime.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-UseMeteredNetwork
Geeft aan of clients na de deadline inhoud mogen downloaden via een internetverbinding naar gebruik, wat extra kosten met zich mee kan brengen.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-UserNotification
Hiermee geeft u het type gebruikersmelding.
DisplayAll: Weergeven in Software Center en alle meldingen weergeven.DisplaySoftwareCenterOnly: wordt weergegeven in Software Center en geeft alleen meldingen weer over het opnieuw opstarten van de computer.HideAll: Verbergen in Software Center en alle meldingen.
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
Hiermee wordt weergegeven wat er zou gebeuren als u de cmdlet uitvoert. De cmdlet wordt niet uitgevoerd.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: wi
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-AutoCloseExecutable
Stel vanaf versie 2107 deze parameter in op om de implementatie-instelling voor de toepassing in te $true stellen voor het installatiegedrag. Gebruik vervolgens de cmdlet Add-CMDeploymentTypeInstallBehavior om een uitvoerbaar bestand toe te voegen om te controleren of de installatie niet wordt uitgevoerd.
Stel deze parameter in op $false om deze optie in de volgende situaties uit te schakelen:
- Wanneer u de cmdlet Remove-CMDeploymentTypeInstallBehavior gebruikt om alle uitvoerbare bestanden te verwijderen
- U wilt niet dat de implementatie controleert op het uitvoeren van uitvoerbare bestanden.
Type: Boolean
Parameter Sets: (All)
Aliases: AutoCloseExeOnInstallBehavior
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
CommonParameters
Deze cmdlet biedt ondersteuning voor de meest gebruikte parameters: -Debug, - ErrorAction, - ErrorVariable, - InformationAction, -InformationVariable, - OutVariable,-OutBuffer, - PipelineVariable - Verbose, - WarningAction en -WarningVariable. Zie voor meer informatie about_CommonParameters.