New-CMApplicationGroupDeployment
Crie uma implementação para um grupo de aplicações.
Sintaxe
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>] Description
Crie uma implementação para um grupo de aplicações. Um grupo de aplicações contém várias aplicações e os utilizadores veem o grupo no Centro de Software como uma única entidade. Para obter mais informações, veja Criar grupos de aplicações.
Antes de poder implementar um grupo de aplicações, tem de criá-lo. Em seguida, pode implementá-la numa coleção de utilizadores ou dispositivos como uma única implementação.
Observação
Execute cmdlets do Configuration Manager a partir da unidade do site do Configuration Manager, por exemplo PS XYZ:\>. Para obter mais informações, veja Introdução.
Exemplos
Exemplo 1
$collection = Get-CMCollection -Name "co1"
$distributionPointName = "dp1.contoso.com"
New-CMApplicationGroupDeployment -Id 16777536 -Collection $collection -DistributionPointName $distributionPointName -DistributeContentParâmetros
-AvailableDateTime
Especifique um objeto DateTime para quando esta implementação estiver disponível. Para obter este objeto, utilize o cmdlet incorporado Get-Date .
Utilize DeadlineDateTime para especificar a atribuição de implementação ou o prazo.
| Tipo: | DateTime |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-Collection
Especifique um objeto de coleção como destino para esta implementação de grupo de aplicações. Para obter este objeto, utilize o cmdlet Get-CMCollection .
| Tipo: | IResultObject |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-CollectionId
Especifique um ID de coleção como destino para esta implementação de grupo de aplicações.
| Tipo: | String |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-CollectionName
Especifique um nome de coleção como destino para esta implementação de grupo de aplicações.
| Tipo: | String |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | True |
-Comment
Especifique um comentário opcional para a implementação do grupo de aplicações.
| Tipo: | String |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-Confirm
Solicita a confirmação antes de executar o cmdlet.
| Tipo: | SwitchParameter |
| Aliases: | cf |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-DeadlineDateTime
Especifique um objeto DateTime para quando esta implementação é atribuída, também conhecido como prazo limite. Para obter este objeto, utilize o cmdlet incorporado Get-Date .
Utilize -AvailableDateTime para especificar quando a implementação está disponível.
| Tipo: | DateTime |
| Aliases: | SupersedenceDeadlineDateTime |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-DeployAction
Especifique se esta implementação é para instalar ou desinstalar o grupo de aplicações.
| Tipo: | DeployActionType |
| Valores aceitos: | Install, Uninstall |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-DeployPurpose
Especifique se esta implementação está disponível para instalação por parte dos utilizadores ou se é necessário instalar no prazo.
| Tipo: | DeployPurposeType |
| Valores aceitos: | Available, Required |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-DisableWildcardHandling
Este parâmetro trata os carateres universais como valores de carateres literais. Não pode combiná-lo com ForceWildcardHandling.
| Tipo: | SwitchParameter |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-DistributeCollectionName
O site distribui conteúdo para os grupos de pontos de distribuição associados a este nome de coleção.
| Tipo: | String |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-DistributeContent
Adicione este parâmetro para distribuir o conteúdo do grupo de aplicações quando criar esta implementação. Os clientes não podem instalar as aplicações até distribuir conteúdo por pontos de distribuição aos quais os clientes podem aceder.
| Tipo: | SwitchParameter |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-DistributionPointGroupName
O site distribui conteúdo para este grupo de pontos de distribuição.
| Tipo: | String |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-DistributionPointName
O site distribui conteúdo para este ponto de distribuição.
| Tipo: | String |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-EnableMomAlert
Defina este parâmetro como para $true ativar o modo de manutenção do System Center Operations Manager para esta implementação.
| Tipo: | Boolean |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-ForceWildcardHandling
Este parâmetro processa carateres universais e pode levar a um comportamento inesperado (não recomendado). Não pode combiná-lo com DisableWildcardHandling.
| Tipo: | SwitchParameter |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-GenerateScomAlertOnFailure
Defina este parâmetro como $true para gerar um alerta do System Center Operations Manager quando a implementação falhar.
| Tipo: | Boolean |
| Aliases: | RaiseMomAlertsOnFailure |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-Id
Especifique o ID do grupo de aplicações a implementar.
| Tipo: | Int32 |
| Aliases: | CIId, CI_ID, ApplicationGroupId |
| Cargo: | 0 |
| Valor padrão: | None |
| Obrigatório: | True |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-InputObject
Especifique um objeto para o grupo de aplicações. Para obter este objeto, utilize o cmdlet Get-CMApplicationGroup .
| Tipo: | IResultObject |
| Aliases: | ApplicationGroup |
| Cargo: | 0 |
| Valor padrão: | None |
| Obrigatório: | True |
| Aceitar a entrada de pipeline: | True |
| Aceitar caracteres curinga: | False |
-Name
Especifique um nome para esta implementação de grupo de aplicações.
| Tipo: | String |
| Aliases: | LocalizedDisplayName, ApplicationGroupName |
| Cargo: | 0 |
| Valor padrão: | None |
| Obrigatório: | True |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-OverrideServiceWindow
Defina este parâmetro como $true para instalar o grupo de aplicações fora de uma janela de manutenção.
| Tipo: | Boolean |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-PersistOnWriteFilterDevice
Utilize este parâmetro para processar filtros de escrita para dispositivos Windows Embedded. Se o definir como $true, o dispositivo consolida as alterações no prazo ou durante uma janela de manutenção. Esta ação requer um reinício. Se o definir como $false, o dispositivo guarda as alterações à sobreposição temporária e consolida-as mais tarde.
| Tipo: | Boolean |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-RebootOutsideServiceWindow
Defina este parâmetro como para $true permitir que o dispositivo reinicie fora de uma janela de manutenção.
| Tipo: | Boolean |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-SendWakeupPacket
Indica se pretende enviar um pacote de reativação para computadores antes do início da implementação. Se este valor for $True, o Configuration Manager reativa um computador do modo de suspensão. Se este valor for $False, não reativa os computadores do modo de suspensão. Para que os computadores reativam, configure primeiro a Reativação por LAN.
| Tipo: | Boolean |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-TimeBaseOn
Especifique o fuso horário a utilizar:
-
LocalTime: utilize a hora local do dispositivo. -
UTC: Utilize a Hora Universal Coordenada (UTC).
| Tipo: | TimeType |
| Valores aceitos: | LocalTime, Utc |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-UseMeteredNetwork
Indica se pretende permitir que os clientes numa ligação à Internet com tráfego limitado transfiram conteúdo após o prazo de instalação, o que pode incorrer em custos adicionais.
| Tipo: | Boolean |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-UserNotification
Utilize este parâmetro para especificar a experiência de utilizador para esta implementação:
-
DisplayAll: apresentar no Centro de Software e mostrar todas as notificações -
DisplaySoftwareCenterOnly: apresentar no Centro de Software e mostrar apenas notificações de reinícios do computador. -
HideAll: Ocultar no Centro de Software e em todas as notificações
| Tipo: | UserNotificationType |
| Valores aceitos: | DisplayAll, DisplaySoftwareCenterOnly, HideAll |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-WhatIf
Mostrar o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.
| Tipo: | SwitchParameter |
| Aliases: | wi |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
Entradas
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
Saídas
IResultObject
Observações
Este cmdlet devolve o SMS_ApplicationGroupAssignment objeto de classe WMI.