New-CMApplicationGroupDeployment

Modul:

ConfigurationManager

Erstellen sie eine Bereitstellung für eine Anwendungsgruppe.

Syntax

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

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

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

Beschreibung

Erstellen sie eine Bereitstellung für eine Anwendungsgruppe. Eine App-Gruppe enthält mehrere Anwendungen, und Benutzer sehen die Gruppe im Software Center als einzelne Entität. Weitere Informationen finden Sie unter Erstellen von Anwendungsgruppen.

Bevor Sie eine App-Gruppe bereitstellen können, müssen Sie sie erstellen. Anschließend können Sie sie als einzelne Bereitstellung für einen Benutzer oder eine Gerätesammlung bereitstellen.

Hinweis

Führen Sie Configuration Manager-Cmdlets beispielsweise vom Configuration Manager-Standortlaufwerk PS XYZ:\> aus. Weitere Informationen finden Sie unter "Erste Schritte".

Beispiele

Beispiel1

$collection = Get-CMCollection -Name "co1"

$distributionPointName = "dp1.contoso.com"

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

Parameter

-AvailableDateTime

Geben Sie ein DateTime -Objekt an, wenn diese Bereitstellung _verfügbar_ist. Verwenden Sie zum Abrufen dieses Objekts das integrierte Cmdlet "Get-Date".

Verwenden Sie DeadlineDateTime, um die Bereitstellungszuweisung oder den _Stichtag_anzugeben.

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

-Collection

Geben Sie ein Sammlungsobjekt als Ziel für diese App-Gruppenbereitstellung an. Verwenden Sie zum Abrufen dieses Objekts das Cmdlet "Get-CMCollection".

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

-CollectionId

Geben Sie eine Sammlungs-ID als Ziel für diese App-Gruppenbereitstellung an.

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

-CollectionName

Geben Sie einen Sammlungsnamen als Ziel für diese App-Gruppenbereitstellung an.

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

-Comment

Geben Sie einen optionalen Kommentar für die App-Gruppenbereitstellung an.

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

-Confirm

Fordert Sie vor dem Ausführen des Cmdlets zur Bestätigung auf.

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-DeadlineDateTime

Geben Sie ein DateTime -Objekt für den Zeitpunkt an, zu dem diese Bereitstellung zugewiesen ist, auch als _Stichtag_bezeichnet. Verwenden Sie zum Abrufen dieses Objekts das integrierte Cmdlet "Get-Date".

Verwenden Sie "-AvailableDateTime", um anzugeben, wann die Bereitstellung _verfügbar_ist.

Type:	DateTime
Aliases:	SupersedenceDeadlineDateTime
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-DeployAction

Geben Sie an, ob diese Bereitstellung die App-Gruppe installieren oder deinstallieren soll.

Type:	DeployActionType
Accepted values:	Install, Uninstall
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-DeployPurpose

Geben Sie an, ob diese Bereitstellung für Benutzer zur Installation verfügbar ist oder ob sie zum Stichtag installiert werden muss.

Type:	DeployPurposeType
Accepted values:	Available, Required
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-DisableWildcardHandling

Dieser Parameter behandelt Platzhalterzeichen als Literalzeichenwerte. Sie können es nicht mit ForceWildcardHandlingkombinieren.

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

-DistributeCollectionName

Die Website verteilt Inhalte an die Verteilerpunktgruppen, die diesem Sammlungsnamen zugeordnet sind.

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

-DistributeContent

Fügen Sie diesen Parameter hinzu, um die App-Gruppeninhalte zu verteilen, wenn Sie diese Bereitstellung erstellen. Clients können die Anwendungen erst installieren, wenn Sie Inhalte an Verteilungspunkte verteilen, auf die die Clients zugreifen können.

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

-DistributionPointGroupName

Die Website verteilt Inhalte an diese Verteilerpunktgruppe.

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

-DistributionPointName

Die Website verteilt Inhalte an diesen Verteilungspunkt.

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

-EnableMomAlert

Legen Sie diesen Parameter $true fest, um System Center Operations Manager-Wartungsmodus für diese Bereitstellung zu aktivieren.

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

-ForceWildcardHandling

Dieser Parameter verarbeitet Platzhalterzeichen und kann zu unerwartetem Verhalten führen (nicht empfohlen). Sie können es nicht mit DisableWildcardHandlingkombinieren.

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

-GenerateScomAlertOnFailure

Legen Sie diesen Parameter $true fest, um eine System Center Operations Manager-Warnung zu generieren, wenn die Bereitstellung fehlschlägt.

Type:	Boolean
Aliases:	RaiseMomAlertsOnFailure
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-Id

Geben Sie die ID der bereitzustellenden Anwendungsgruppe an.

Type:	Int32
Aliases:	CIId, CI_ID, ApplicationGroupId
Position:	0
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-InputObject

Geben Sie ein Objekt für die App-Gruppe an. Verwenden Sie zum Abrufen dieses Objekts das Cmdlet "Get-CMApplicationGroup".

Type:	IResultObject
Aliases:	ApplicationGroup
Position:	0
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-Name

Geben Sie einen Namen für diese App-Gruppenbereitstellung an.

Type:	String
Aliases:	LocalizedDisplayName, ApplicationGroupName
Position:	0
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-OverrideServiceWindow

Legen Sie diesen Parameter $true fest, um die App-Gruppe außerhalb eines Wartungsfensters zu installieren.

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

-PersistOnWriteFilterDevice

Verwenden Sie diesen Parameter, um Schreibfilter für Windows Eingebettete Geräte zu behandeln. Wenn Sie dies $true festlegen, führt das Gerät einen Commit für Änderungen zum Stichtag oder während eines Wartungsfensters durch. Diese Aktion erfordert einen Neustart. Wenn Sie dies $false festlegen, speichert das Gerät Änderungen an der temporären Überlagerung und führt später einen Commit durch.

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

-RebootOutsideServiceWindow

Legen Sie diesen Parameter so $true fest, dass das Gerät außerhalb eines Wartungsfensters neu gestartet werden kann.

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

-SendWakeupPacket

Gibt an, ob ein Reaktivierungspaket an Computer gesendet werden soll, bevor die Bereitstellung beginnt. Wenn dieser Wert $True ist, aktiviert Configuration Manager einen Computer aus dem Ruhezustand. Wenn dieser Wert $False ist, werden Computer nicht aus dem Ruhezustand aktiviert. Damit Computer aktiviert werden können, konfigurieren Sie zuerst "Wake On LAN".

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

-TimeBaseOn

Geben Sie an, welche Zeitzone verwendet werden soll:

• LocalTime: Verwenden Sie die Ortszeit des Geräts.
• UTC: Koordinierte Weltzeit (COORDINATED Universal Time, UTC) verwenden.

Type:	TimeType
Accepted values:	LocalTime, Utc
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-UseMeteredNetwork

Gibt an, ob clients on a metered internet connection to download content after the installation deadline, which might incurs additional costs.

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

-UserNotification

Verwenden Sie diesen Parameter, um die Benutzererfahrung für diese Bereitstellung anzugeben:

• DisplayAll: Anzeigen im Software Center und Anzeigen aller Benachrichtigungen
• DisplaySoftwareCenterOnly: Wird im Software Center angezeigt und zeigt nur Benachrichtigungen über Computerneustarts an.
• HideAll: Ausblenden im Software Center und aller Benachrichtigungen

Type:	UserNotificationType
Accepted values:	DisplayAll, DisplaySoftwareCenterOnly, HideAll
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-WhatIf

Zeigt, was passieren würde, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

Eingaben

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Ausgaben

IResultObject

Hinweise

Dieses Cmdlet gibt das SMS_ApplicationGroupAssignment WMI-Klassenobjekt zurück.

Ähnliche Themen

• Get-CMApplicationGroupDeployment
• Remove-CMApplicationGroupDeployment
• Set-CMApplicationGroupDeployment
• Get-CMApplicationGroup
• Anwendungsgruppen erstellen