New-CMApplicationGroupDeployment
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 Benutzern wird die Gruppe im Softwarecenter als einzelne Entität angezeigt. 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 es für eine Benutzer- oder Gerätesammlung als einzelne Bereitstellung bereitstellen.
Hinweis
Führen Sie Configuration Manager-Cmdlets auf dem Configuration Manager-Standortlaufwerk aus, z. B PS XYZ:\>. . Weitere Informationen finden Sie unter Erste Schritte.
Beispiele
Beispiel 1
$collection = Get-CMCollection -Name "co1"
$distributionPointName = "dp1.contoso.com"
New-CMApplicationGroupDeployment -Id 16777536 -Collection $collection -DistributionPointName $distributionPointName -DistributeContentParameter
-AvailableDateTime
Geben Sie ein DateTime-Objekt für den Zeitpunkt an, an dem 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.
| Typ: | DateTime |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-Collection
Geben Sie ein Auflistungsobjekt als Ziel für diese App-Gruppenbereitstellung an. Verwenden Sie zum Abrufen dieses Objekts das Cmdlet Get-CMCollection .
| Typ: | IResultObject |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-CollectionId
Geben Sie eine Sammlungs-ID als Ziel für diese App-Gruppenbereitstellung an.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-CollectionName
Geben Sie einen Sammlungsnamen als Ziel für diese App-Gruppenbereitstellung an.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | True |
-Comment
Geben Sie einen optionalen Kommentar für die App-Gruppenbereitstellung an.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-Confirm
Fordert Sie vor dem Ausführen des Cmdlets zur Bestätigung auf.
| Typ: | SwitchParameter |
| Aliase: | cf |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-DeadlineDateTime
Geben Sie für die Bereitstellung ein DateTime-Objekt an, das auch als Stichtag bezeichnet wird. Verwenden Sie zum Abrufen dieses Objekts das integrierte Cmdlet Get-Date .
Verwenden Sie -AvailableDateTime , um anzugeben, wann die Bereitstellung verfügbar ist.
| Typ: | DateTime |
| Aliase: | SupersedenceDeadlineDateTime |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-DeployAction
Geben Sie an, ob diese Bereitstellung die App-Gruppe installieren oder deinstallieren soll.
| Typ: | DeployActionType |
| Zulässige Werte: | Install, Uninstall |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-DeployPurpose
Geben Sie an, ob diese Bereitstellung für Benutzer zur Installation verfügbar ist oder ob die Installation zum Stichtag erforderlich ist.
| Typ: | DeployPurposeType |
| Zulässige Werte: | Available, Required |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-DisableWildcardHandling
Dieser Parameter behandelt Wildcardzeichen als Literalzeichenwerte. Sie können es nicht mit ForceWildcardHandling kombinieren.
| Typ: | SwitchParameter |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-DistributeCollectionName
Die Website verteilt Inhalt an die Verteilungspunktgruppen, die diesem Sammlungsnamen zugeordnet sind.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-DistributeContent
Fügen Sie diesen Parameter hinzu, um den App-Gruppeninhalt 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.
| Typ: | SwitchParameter |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-DistributionPointGroupName
Der Standort verteilt Inhalte an diese Verteilungspunktgruppe.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-DistributionPointName
Der Standort verteilt Inhalte an diesen Verteilungspunkt.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-EnableMomAlert
Legen Sie diesen Parameter auf fest $true , um den System Center Operations Manager-Wartungsmodus für diese Bereitstellung zu aktivieren.
| Typ: | Boolean |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-ForceWildcardHandling
Dieser Parameter verarbeitet Wildcardzeichen und kann zu unerwartetem Verhalten führen (nicht empfohlen). Sie können es nicht mit DisableWildcardHandling kombinieren.
| Typ: | SwitchParameter |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-GenerateScomAlertOnFailure
Legen Sie diesen Parameter auf fest $true , um eine System Center Operations Manager-Warnung zu generieren, wenn die Bereitstellung fehlschlägt.
| Typ: | Boolean |
| Aliase: | RaiseMomAlertsOnFailure |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-Id
Geben Sie die ID der bereitzustellenden Anwendungsgruppe an.
| Typ: | Int32 |
| Aliase: | CIId, CI_ID, ApplicationGroupId |
| Position: | 0 |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-InputObject
Geben Sie ein Objekt für die App-Gruppe an. Verwenden Sie zum Abrufen dieses Objekts das Cmdlet Get-CMApplicationGroup .
| Typ: | IResultObject |
| Aliase: | ApplicationGroup |
| Position: | 0 |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | True |
| Platzhalterzeichen akzeptieren: | False |
-Name
Geben Sie einen Namen für diese App-Gruppenbereitstellung an.
| Typ: | String |
| Aliase: | LocalizedDisplayName, ApplicationGroupName |
| Position: | 0 |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-OverrideServiceWindow
Legen Sie diesen Parameter auf fest $true , um die App-Gruppe außerhalb eines Wartungsfensters zu installieren.
| Typ: | Boolean |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-PersistOnWriteFilterDevice
Verwenden Sie diesen Parameter, um Schreibfilter für Windows Embedded-Geräte zu behandeln. Wenn Sie es auf $truefestlegen, übernimmt das Gerät Änderungen am Stichtag oder während eines Wartungsfensters. Diese Aktion erfordert einen Neustart. Wenn Sie es auf $falsefestlegen, speichert das Gerät Änderungen an der temporären Überlagerung und committet sie später.
| Typ: | Boolean |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-RebootOutsideServiceWindow
Legen Sie diesen Parameter auf fest $true , damit das Gerät außerhalb eines Wartungsfensters neu gestartet werden kann.
| Typ: | Boolean |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-SendWakeupPacket
Gibt an, ob vor Beginn der Bereitstellung ein Aktivierungspaket an Computer gesendet werden soll. Wenn dieser Wert ist $True, reaktiviert Configuration Manager einen Computer aus dem Ruhezustand. Wenn dieser Wert ist $False, werden Computer nicht aus dem Ruhezustand reaktiviert. Damit Computer aktiviert werden können, konfigurieren Sie zuerst Wake-On-LAN.
| Typ: | Boolean |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-TimeBaseOn
Geben Sie an, welche Zeitzone verwendet werden soll:
-
LocalTime: Verwenden Sie die Ortszeit des Geräts. -
UTC: Verwenden Sie koordinierte Weltzeit (UTC).
| Typ: | TimeType |
| Zulässige Werte: | LocalTime, Utc |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-UseMeteredNetwork
Gibt an, ob Clients über eine getaktete Internetverbindung inhalte nach dem Installationsstichtag herunterladen dürfen, was zusätzliche Kosten verursachen kann.
| Typ: | Boolean |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-UserNotification
Verwenden Sie diesen Parameter, um die Benutzeroberfläche für diese Bereitstellung anzugeben:
-
DisplayAll: Anzeigen im Softwarecenter und Anzeigen aller Benachrichtigungen -
DisplaySoftwareCenterOnly: Wird im Softwarecenter angezeigt, und zeigt nur Benachrichtigungen über Computerneustarts an. -
HideAll: Im Softwarecenter und alle Benachrichtigungen ausblenden
| Typ: | UserNotificationType |
| Zulässige Werte: | DisplayAll, DisplaySoftwareCenterOnly, HideAll |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-WhatIf
Zeigt, was passieren würde, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.
| Typ: | SwitchParameter |
| Aliase: | wi |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
Eingaben
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
Ausgaben
IResultObject
Hinweise
Dieses Cmdlet gibt das SMS_ApplicationGroupAssignment WMI-Klassenobjekt zurück.