New-CMApplicationGroupDeployment

SYNOPSIS

Skapa en distribution för en programgrupp.

SYNTAX

SearchByValueMandatory (standard)

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

Skapa en distribution för en programgrupp. En appgrupp innehåller flera program och användarna ser gruppen i Software Center som en enda entitet. Mer information finns i Skapa programgrupper.

Innan du kan distribuera en appgrupp måste du skapa den. Sedan kan du distribuera den till en användar- eller enhetssamling som en enda distribution.

Anteckning

Kör Konfigurationshanteraren cmdlets från Konfigurationshanteraren platsenheten, till exempel PS XYZ:\> . Mer information finns i Komma igång.

EXAMPLES

Exempel 1

$collection = Get-CMCollection -Name "co1"

$distributionPointName = "dp1.contoso.com"

New-CMApplicationGroupDeployment -Id 16777536 -Collection $collection -DistributionPointName $distributionPointName -DistributeContent

PARAMETERS

-AvailableDateTime

Ange ett DateTime-objekt för när distributionen är tillgänglig. Hämta det här objektet med hjälp av den inbyggda cmdleten Get-Date.

Använd DeadlineDateTime för att ange distributionstilldelningen eller tidsgränsen.

Type: DateTime
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Samling

Ange ett samlingsobjekt som mål för den här appgruppsdistributionen. Hämta det här objektet med cmdleten Get-CMCollection.

Type: IResultObject
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-CollectionId

Ange ett samlings-ID som mål för den här appgruppsdistributionen.

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-CollectionName

Ange ett samlingsnamn som mål för den här appgruppsdistributionen.

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: True

-Kommentar

Ange en valfri kommentar för distributionen av appgruppen.

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Confirm

Uppmanar dig att bekräfta innan du kör cmdleten.

Type: SwitchParameter
Parameter Sets: (All)
Aliases: cf

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-DeadlineDateTime

Ange ett DateTime-objekt för när den här distributionen tilldelas, även kallat tidsgränsen. Hämta det här objektet med hjälp av den inbyggda cmdleten Get-Date.

Använd -AvailableDateTime för att ange när distributionen är tillgänglig.

Type: DateTime
Parameter Sets: (All)
Aliases: SupersedenceDeadlineDateTime

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-DeployAction

Ange om den här distributionen ska installera eller avinstallera appgruppen.

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

Ange om den här distributionen är tillgänglig för användare att installera, eller om den måste installeras vid tidsgränsen.

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

Den här parametern behandlar jokertecken som värden för literaltecken. Du kan inte kombinera den med ForceWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-DistributeCollectionName

Webbplatsen distribuerar innehåll till de distributionsplatsgrupper som är associerade med det här samlingsnamnet.

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-DistributeContent

Lägg till den här parametern för att distribuera appgruppens innehåll när du skapar den här distributionen. Klienter kan inte installera programmen förrän du distribuerar innehåll till distributionsplatser som klienterna kan komma åt.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-DistributionPointGroupName

Platsen distribuerar innehåll till den här distributionsplatsgruppen.

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-DistributionPointName

Platsen distribuerar innehåll till den här distributionsplatsen.

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-EnableMomAlert

Ställ in den här $true parametern på för System Center Operations Manager aktivera underhållsläget för den här distributionen.

Type: Boolean
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-ForceWildcardHandling

Den här parametern bearbetar jokertecken och kan leda till oväntat beteende (rekommenderas inte). Du kan inte kombinera den med DisableWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-GenerateScomAlertOnFailure

Ange den här $true parametern till för att System Center Operations Manager en avisering när distributionen misslyckas.

Type: Boolean
Parameter Sets: (All)
Aliases: RaiseMomAlertsOnFailure

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Id

Ange ID för den programgrupp som ska distribueras.

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

Ange ett objekt för appgruppen. Hämta det här objektet med hjälp av cmdleten Get-CMApplicationGroup.

Type: IResultObject
Parameter Sets: SearchByValueMandatory
Aliases: ApplicationGroup

Required: True
Position: 0
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False

-Name

Ange ett namn för den här appgruppsdistributionen.

Type: String
Parameter Sets: SearchByNameMandatory
Aliases: LocalizedDisplayName, ApplicationGroupName

Required: True
Position: 0
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-OverrideServiceWindow

Ange den här $true parametern till för att installera appgruppen utanför en underhållsfönstret.

Type: Boolean
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-PersistOnWriteFilterDevice

Använd den här parametern för att hantera skrivfilter för Windows Embedded-enheter. Om du ställer in den $true på , genomför enheten ändringar vid tidsgränsen eller under en underhållsfönstret. Den här åtgärden kräver en omstart. Om du ställer in den $false på sparar enheten ändringar i det tillfälliga överlägget och genomför dem senare.

Type: Boolean
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-RebootOutsideServiceWindow

Ange den här $true parametern till för att tillåta att enheten startas om utanför en underhållsfönstret.

Type: Boolean
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-SendWakeupPacket

Anger om ett aktiveringspaket ska skickas till datorer innan distributionen påbörjas. Om det här värdet $True är Konfigurationshanteraren en dator från strömsparläge. Om det här värdet $False är väcks inte datorer från strömsparläge. För att datorer ska aktiveras måste du först konfigurera 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

Ange vilken tidszon som ska användas:

• LocalTime: Använd enhetens lokala tid.
• UTC: Använd 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

Anger om klienter på en avgiftsuppladdad Internetanslutning ska kunna ladda ned innehåll efter tidsgränsen för installationen, vilket kan medföra ytterligare kostnader.

Type: Boolean
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-UserNotification

Använd den här parametern för att ange användarupplevelsen för den här distributionen:

• DisplayAll: Visas i Software Center och visar alla meddelanden
• DisplaySoftwareCenterOnly: Visas i Software Center och visar endast meddelanden om omstarter av datorn.
• HideAll: Dölj i Software Center och alla meddelanden

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

Visar vad som skulle hända om cmdleten kördes. Cmdleten körs inte.

Type: SwitchParameter
Parameter Sets: (All)
Aliases: wi

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

CommonParameters

Denna cmdlet har stöd för parametrarna -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.

INPUTS

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

OUTPUTS

IResultObject#SMS_ApplicationGroupAssignment

ANTECKNINGAR

Den här cmdleten returnerar SMS_ApplicationGroupAssignment WMI-klassobjektet.

RELATED LINKS

Get-CMApplicationGroupDeployment

Remove-CMApplicationGroupDeployment

Set-CMApplicationGroupDeployment

Get-CMApplicationGroup

Skapa programgrupper