Delen via


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 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

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.

Get-CMApplicationGroupDeployment

Remove-CMApplicationGroupDeployment

Set-CMApplicationGroupDeployment

Get-CMApplicationGroup

Toepassingsgroepen maken