Set-CMApplicationDeployment
SYNOPSIS
Een toepassingsimplementatie configureren
SYNTAX
SetApplicationDeploymentByValueMandatory (standaard)
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
De cmdlet Set-CMApplicationDeployment wijzigt de eigenschappen van een toepassingsimplementatie in Configuration Manager. Zie Deploy applications with Configuration Manager (Toepassingen implementeren met Configuration Manager) voor meer informatie.
Als u een toepassingsimplementatie wilt opgeven die moet worden gewijzigd, geeft u de naam van de verzameling en de toepassing op. U kunt een toepassing opgeven op naam of id. U kunt ook de cmdlet Get-CMApplication gebruiken om een toepassing te laten wijzigen.
Notitie
Voer Configuration Manager cmdlets uit vanaf Configuration Manager sitestation, bijvoorbeeld PS XYZ:\>
. Zie Aan de slag voor meer informatie.
EXAMPLES
Voorbeeld 1: Beschikbaarheid en deadline voor een toepassingsimplementatie wijzigen
Set-CMApplicationDeployment -ApplicationName "Track System 2011" -CollectionName "All Users" -AvailableDateTime (Get-Date) -DeadlineDateTime $(Get-Date).AddDays(30)
Met deze opdracht wijzigt u een toepassingsimplementatie voor een toepassing met de naam Track System 2011 voor een verzameling met de naam Alle gebruikers. Met de opdracht geeft u de huidige datum op waarop de toepassing beschikbaar is. Ook wordt de implementatiedeadline voor 30 dagen in de toekomst geconfigureerd.
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
-ApplicationId
Hiermee geeft u de id van een toepassing op.
Type: String
Parameter Sets: SetApplicationDeploymentByIdMandatory
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ApplicationName
Hiermee geeft u de naam van een toepassing op.
Type: String
Parameter Sets: SetApplicationDeploymentByNameMandatory
Aliases:
Required: True
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 de 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 de 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
Hiermee geeft u een optionele opmerking voor de 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: False
Accept pipeline input: False
Accept wildcard characters: False
-CreateAlertBaseOnPercentFailure
Geeft aan of er een waarschuwing moet worden ingediend voor een percentage van de toepassingen die niet kunnen worden geïmplementeerd. Als u de percentagewaarde wilt opgeven, gebruikt u de parameter FailParameterValue.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-CreateAlertBaseOnPercentSuccess
Geeft aan of er een waarschuwing moet worden gedaan voor een percentage van de toepassingen die zijn geïmplementeerd. Als u de percentagewaarde wilt opgeven, gebruikt u de parameter SuccessParameterValue.
Type: Boolean
Parameter Sets: (All)
Aliases:
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:
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
-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
-InputObject
Geef een toepassingsimplementatieobject op dat u wilt configureren. Gebruik de cmdlet Get-CMApplicationDeployment om dit object op te halen.
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
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
-PassThru
Voeg deze parameter toe om een -object te retourneren dat het item vertegenwoordigt waarmee u werkt. Standaard is het mogelijk dat deze cmdlet geen uitvoer genereert.
Type: SwitchParameter
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
-RaiseMomAlertsOnFailure
Geeft aan of er een waarschuwing moet Operations Manager als een client de toepassing niet kan installeren.
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
-RequireApproval
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
-SendWakeUpPacket
Geeft aan of een wake-up pakket naar computers moet worden verzenden voordat de implementatie begint.
Als deze waarde $True
is, probeert Configuration Manager 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 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
Hiermee geeft u het percentage geslaagde toepassingsinstallatie op dat een waarschuwing veroorzaakt.
Geef een geheel getal van 0 tot en met 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
: Gebruik lokale tijd.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
-UseMeteredNetwork
Geeft aan of clients na de deadline inhoud via een internetverbinding naar gebruik mogen downloaden, 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: False
Accept pipeline input: False
Accept wildcard characters: False
-AutoCloseExecutable
Vanaf versie 2107 stelt u deze parameter in op om de implementatie-instelling voor de toepassing in te $true
stellen voor 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.
INPUTS
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
OUTPUTS
IResultObject#SMS_ApplicationAssignment
OPMERKINGEN
Zie WMI-klasse SMS_ApplicationAssignment server voor meer informatie over dit retourobjecten de eigenschappen ervan.