New-CMApplicationGroupDeployment
SYNOPSIS
Maak een implementatie voor een toepassingsgroep.
SYNTAX
SearchByValueMandatory (standaard)
New-CMApplicationGroupDeployment [-DeadlineDateTime <DateTime>] [-DeployAction <DeployActionType>]
[-DeployPurpose <DeployPurposeType>] [-EnableMomAlert <Boolean>] [-GenerateScomAlertOnFailure <Boolean>]
[-InputObject] <IResultObject> [-OverrideServiceWindow <Boolean>] [-RebootOutsideServiceWindow <Boolean>]
[-TimeBaseOn <TimeType>] [-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-CMApplicationGroupDeployment [-DeadlineDateTime <DateTime>] [-DeployAction <DeployActionType>]
[-DeployPurpose <DeployPurposeType>] [-EnableMomAlert <Boolean>] [-GenerateScomAlertOnFailure <Boolean>]
[-Id] <Int32> [-OverrideServiceWindow <Boolean>] [-RebootOutsideServiceWindow <Boolean>]
[-TimeBaseOn <TimeType>] [-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-CMApplicationGroupDeployment [-DeadlineDateTime <DateTime>] [-DeployAction <DeployActionType>]
[-DeployPurpose <DeployPurposeType>] [-EnableMomAlert <Boolean>] [-GenerateScomAlertOnFailure <Boolean>]
[-Name] <String> [-OverrideServiceWindow <Boolean>] [-RebootOutsideServiceWindow <Boolean>]
[-TimeBaseOn <TimeType>] [-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
Maak een implementatie voor een toepassingsgroep. Een app-groep bevat meerdere toepassingen en gebruikers zien de groep in Software Center als één entiteit. Zie Toepassingsgroepen maken voor meer informatie.
Voordat u een app-groep kunt implementeren, moet u deze maken. Vervolgens kunt u deze als één implementatie implementeren voor een gebruikers- of apparaatverzameling.
Notitie
Voer Configuration Manager cmdlets uit vanaf Configuration Manager-sitestation, bijvoorbeeld PS XYZ:\>
. Zie Aan de slag voor meer informatie.
EXAMPLES
Voorbeeld 1
$collection = Get-CMCollection -Name "co1"
$distributionPointName = "dp1.contoso.com"
New-CMApplicationGroupDeployment -Id 16777536 -Collection $collection -DistributionPointName $distributionPointName -DistributeContent
PARAMETERS
-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 als doel voor de implementatie van deze app-groep. 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 een verzamelings-id op als doel voor de implementatie van deze app-groep.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-CollectionName
Geef een verzamelingsnaam op als het doel voor de implementatie van deze app-groep.
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 de implementatie van de app-groep.
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 op of deze implementatie is om de app-groep te installeren of te verwijderen.
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 op of deze implementatie beschikbaar is voor gebruikers om te installeren of dat deze moet worden geïnstalleerd op de deadline.
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
-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 distributiepuntgroepen 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 om de inhoud van de app-groep te distribueren wanneer u deze implementatie maakt. Clients kunnen de toepassingen pas installeren als u inhoud distribueert naar distributiepunten die de clients kunnen openen.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DistributionPointGroupName
De site distribueert inhoud naar deze distributiepuntgroep.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DistributionPointName
De site distribueert inhoud naar dit distributiepunt.
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 $true
op om de 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
-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
Stel deze parameter in $true
op om een waarschuwing System Center Operations Manager genereren wanneer de implementatie mislukt.
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 toepassingsgroep die moet worden geïmplementeerd.
Type: Int32
Parameter Sets: SearchByIdMandatory
Aliases: CIId, CI_ID, ApplicationGroupId
Required: True
Position: 0
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-InputObject
Geef een object op voor de app-groep. Gebruik de cmdlet Get-CMApplicationGroup om dit object op te halen.
Type: IResultObject
Parameter Sets: SearchByValueMandatory
Aliases: ApplicationGroup
Required: True
Position: 0
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False
-Name
Geef een naam op voor de implementatie van deze app-groep.
Type: String
Parameter Sets: SearchByNameMandatory
Aliases: LocalizedDisplayName, ApplicationGroupName
Required: True
Position: 0
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-OverrideServiceWindow
Stel deze parameter in $true
op om de app-groep buiten een onderhoudsvenster te installeren.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-PersistOnWriteFilterDevice
Gebruik deze parameter voor het afhandelen van schrijffilters voor Windows Embedded-apparaten. Als u deze in stelt op , worden wijzigingen doorgevoerd op de $true
deadline of tijdens een onderhoudsvenster. Voor deze actie is opnieuw opstarten vereist. Als u deze in stelt op $false
, slaat het apparaat wijzigingen op in de tijdelijke 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
-RebootOutsideServiceWindow
Stel deze parameter in op $true
zodat het apparaat opnieuw kan worden 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
-SendWakeupPacket
Geeft aan of een wake-up pakket naar computers moet worden verzenden voordat de implementatie begint. Als deze waarde $True
is, Configuration Manager een computer uit de slaapstand. Als deze waarde $False
is, worden computers niet uit de slaapstand lapt. Om computers te 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
-TimeBaseOn
Geef op welke tijdzone moet worden gebruikt:
LocalTime
: Gebruik de lokale tijd van het apparaat.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 met een internetverbinding naar gebruik inhoud mogen downloaden na de installatiedeadline, 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
Gebruik deze parameter om de gebruikerservaring voor deze implementatie op te geven:
DisplayAll
: Weergeven in Software Center en alle meldingen weergevenDisplaySoftwareCenterOnly
: 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
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_ApplicationGroupAssignment
OPMERKINGEN
Deze cmdlet retourneert de SMS_ApplicationGroupAssignment WMI-klasseobject.
RELATED LINKS
Get-CMApplicationGroupDeployment
Remove-CMApplicationGroupDeployment