Delen via


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.

Get-CMApplication

Get-CMApplicationDeployment

New-CMApplicationDeployment

Remove-CMApplicationDeployment

Toepassingen implementeren met Configuration Manager