Condividi tramite

New-CMApplicationGroupDeployment

  • Riferimento
Modulo:
ConfigurationManager

Creare una distribuzione per un gruppo di applicazioni.

Sintassi

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

Descrizione

Creare una distribuzione per un gruppo di applicazioni. Un gruppo di app contiene più applicazioni e gli utenti vedono il gruppo in Software Center come una singola entità. Per altre informazioni, vedere Creare gruppi di applicazioni.

Prima di poter distribuire un gruppo di app, è necessario crearlo. È quindi possibile distribuirlo in una raccolta di utenti o dispositivi come singola distribuzione.

Nota

Eseguire i cmdlet di Configuration Manager dall'unità del sito di Configuration Manager, ad esempio PS XYZ:\>. Per altre informazioni, vedere Introduzione.

Esempio

Esempio 1

$collection = Get-CMCollection -Name "co1"

$distributionPointName = "dp1.contoso.com"

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

Parametri

-AvailableDateTime

Specificare un oggetto DateTime per quando questa distribuzione è disponibile. Per ottenere questo oggetto, usare il cmdlet predefinito Get-Date .

Usare DeadlineDateTime per specificare l'assegnazione o la scadenza della distribuzione.

Tipo:DateTime
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Collection

Specificare un oggetto raccolta come destinazione per la distribuzione del gruppo di app. Per ottenere questo oggetto, usare il cmdlet Get-CMCollection .

Tipo:IResultObject
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-CollectionId

Specificare un ID raccolta come destinazione per la distribuzione del gruppo di app.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-CollectionName

Specificare un nome di raccolta come destinazione per la distribuzione del gruppo di app.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:True

-Comment

Specificare un commento facoltativo per la distribuzione del gruppo di app.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Confirm

Richiede la conferma prima di eseguire il cmdlet.

Tipo:SwitchParameter
Alias:cf
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-DeadlineDateTime

Specificare un oggetto DateTime per quando viene assegnata questa distribuzione, nota anche come scadenza. Per ottenere questo oggetto, usare il cmdlet predefinito Get-Date .

Utilizzare -AvailableDateTime per specificare quando la distribuzione è disponibile.

Tipo:DateTime
Alias:SupersedenceDeadlineDateTime
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-DeployAction

Specificare se questa distribuzione deve installare o disinstallare il gruppo di app.

Tipo:DeployActionType
Valori accettati:Install, Uninstall
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-DeployPurpose

Specificare se questa distribuzione è disponibile per l'installazione da parte degli utenti o se è necessaria per l'installazione alla scadenza.

Tipo:DeployPurposeType
Valori accettati:Available, Required
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-DisableWildcardHandling

Questo parametro considera i caratteri jolly come valori letterali. Non è possibile combinarlo con ForceWildcardHandling.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-DistributeCollectionName

Il sito distribuisce il contenuto ai gruppi di punti di distribuzione associati al nome della raccolta.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-DistributeContent

Aggiungere questo parametro per distribuire il contenuto del gruppo di app quando si crea questa distribuzione. I client non possono installare le applicazioni fino a quando non si distribuisce il contenuto ai punti di distribuzione a cui i client possono accedere.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-DistributionPointGroupName

Il sito distribuisce il contenuto a questo gruppo di punti di distribuzione.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-DistributionPointName

Il sito distribuisce il contenuto a questo punto di distribuzione.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-EnableMomAlert

Impostare questo parametro su $true per abilitare la modalità di manutenzione di System Center Operations Manager per questa distribuzione.

Tipo:Boolean
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ForceWildcardHandling

Questo parametro elabora caratteri jolly e può causare un comportamento imprevisto (non consigliato). Non è possibile combinarlo con DisableWildcardHandling.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-GenerateScomAlertOnFailure

Impostare questo parametro su $true per generare un avviso di System Center Operations Manager quando la distribuzione ha esito negativo.

Tipo:Boolean
Alias:RaiseMomAlertsOnFailure
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Id

Specificare l'ID del gruppo di applicazioni da distribuire.

Tipo:Int32
Alias:CIId, CI_ID, ApplicationGroupId
Posizione:0
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-InputObject

Specificare un oggetto per il gruppo di app. Per ottenere questo oggetto, usare il cmdlet Get-CMApplicationGroup .

Tipo:IResultObject
Alias:ApplicationGroup
Posizione:0
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-Name

Specificare un nome per la distribuzione del gruppo di app.

Tipo:String
Alias:LocalizedDisplayName, ApplicationGroupName
Posizione:0
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-OverrideServiceWindow

Impostare questo parametro su $true per installare il gruppo di app all'esterno di una finestra di manutenzione.

Tipo:Boolean
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-PersistOnWriteFilterDevice

Usare questo parametro per gestire i filtri di scrittura per i dispositivi Windows Embedded. Se lo $truesi imposta su , il dispositivo esegue il commit delle modifiche alla scadenza o durante una finestra di manutenzione. Questa azione richiede un riavvio. Se lo $falsesi imposta su , il dispositivo salva le modifiche alla sovrimpressione temporanea e le esegue il commit in un secondo momento.

Tipo:Boolean
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-RebootOutsideServiceWindow

Impostare questo parametro su $true per consentire il riavvio del dispositivo all'esterno di una finestra di manutenzione.

Tipo:Boolean
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-SendWakeupPacket

Indica se inviare un pacchetto di riattivazione ai computer prima dell'inizio della distribuzione. Se questo valore è $True, Configuration Manager riattiva un computer dalla sospensione. Se questo valore è $False, non riattiva i computer dalla sospensione. Per consentire la riattivazione dei computer, configurare prima la riattivazione LAN.

Tipo:Boolean
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-TimeBaseOn

Specificare il fuso orario da usare:

  • LocalTime: usare l'ora locale del dispositivo.
  • UTC: usa l'ora UTC (Coordinated Universal Time).
Tipo:TimeType
Valori accettati:LocalTime, Utc
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-UseMeteredNetwork

Indica se consentire ai client in una connessione Internet a consumo di scaricare il contenuto dopo la scadenza dell'installazione, il che potrebbe comportare costi aggiuntivi.

Tipo:Boolean
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-UserNotification

Usare questo parametro per specificare l'esperienza utente per questa distribuzione:

  • DisplayAll: visualizza in Software Center e mostra tutte le notifiche
  • DisplaySoftwareCenterOnly: viene visualizzato in Software Center e vengono visualizzate solo le notifiche dei riavvii del computer.
  • HideAll: nascondi in Software Center e tutte le notifiche
Tipo:UserNotificationType
Valori accettati:DisplayAll, DisplaySoftwareCenterOnly, HideAll
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-WhatIf

Mostra cosa accade se viene eseguito il cmdlet. Il cmdlet non viene eseguito.

Tipo:SwitchParameter
Alias:wi
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

Input

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Output

IResultObject

Note

Questo cmdlet restituisce l'oggetto classe WMI SMS_ApplicationGroupAssignment.