New-CMApplicationGroupDeployment

Módulo:

ConfigurationManager

Crie uma implantação para um grupo de aplicativos.

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

Description

Crie uma implantação para um grupo de aplicativos. Um grupo de aplicativos contém vários aplicativos e os usuários veem o grupo no Centro de Software como uma única entidade. Para obter mais informações, consulte Criar grupos de aplicativos.

Antes de implantar um grupo de aplicativos, você precisa criar. Em seguida, você pode implantá-lo em um conjunto de usuários ou dispositivos como uma única implantação.

Observação

Execute cmdlets do Configuration Manager na unidade de site do Configuration Manager, por PS XYZ:\> exemplo. Para obter mais informações, consulte getting started.

Exemplos

Exemplo 1

$collection = Get-CMCollection -Name "co1"

$distributionPointName = "dp1.contoso.com"

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

Parâmetros

-AvailableDateTime

Especifique um objeto DateTime para quando essa implantação estiver disponível. Para obter esse objeto, use o cmdlet get-Date integrado.

Use DeadlineDateTime para especificar a atribuição de implantação ou o prazo.

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

-Collection

Especifique um objeto collection como o destino para a implantação desse grupo de aplicativos. Para obter esse objeto, use o cmdlet Get-CMCollection.

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

-CollectionId

Especifique uma ID de coleção como o destino para a implantação desse grupo de aplicativos.

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

-CollectionName

Especifique um nome de coleção como o destino para a implantação desse grupo de aplicativos.

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

-Comentário

Especifique um comentário opcional para a implantação do grupo de aplicativos.

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

-Confirm

Solicita a confirmação antes de executar o cmdlet.

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

-DeadlineDateTime

Especifique um objeto DateTime para quando essa implantação for atribuída, também conhecido como o prazo. Para obter esse objeto, use o cmdlet get-Date integrado.

Use -AvailableDateTime para especificar quando a implantação está disponível.

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

-DeployAction

Especifique se essa implantação deve instalar ou desinstalar o grupo de aplicativos.

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

-DeployPurpose

Especifique se essa implantação está disponível para os usuários instalarem ou se é necessário instalar no prazo limite.

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

-DisableWildcardHandling

Este parâmetro trata caracteres curinga como valores literais de caracteres. Não é possível combiná-lo com ForceWildcardHandling.

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

-DistributeCollectionName

O site distribui conteúdo para os grupos de pontos de distribuição associados a esse nome de coleção.

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

-DistributeContent

Adicione esse parâmetro para distribuir o conteúdo do grupo de aplicativos ao criar essa implantação. Os clientes não podem instalar os aplicativos até que você distribua conteúdo para pontos de distribuição que os clientes podem acessar.

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

-DistributionPointGroupName

O site distribui conteúdo para esse grupo de pontos de distribuição.

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

-DistributionPointName

O site distribui conteúdo para esse ponto de distribuição.

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

-EnableMomAlert

De definir esse parâmetro para habilitar System Center modo de manutenção $true do Operations Manager para essa implantação.

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

-ForceWildcardHandling

Esse parâmetro processa caracteres curinga e pode levar a um comportamento inesperado (não recomendado). Não é possível combiná-lo com DisableWildcardHandling.

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

-GenerateScomAlertOnFailure

De definir esse parâmetro como para gerar um alerta System Center Operations Manager quando $true a implantação falhar.

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

-Id

Especifique a ID do grupo de aplicativos a ser implantado.

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

-InputObject

Especifique um objeto para o grupo de aplicativos. Para obter esse objeto, use o cmdlet Get-CMApplicationGroup.

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

-Name

Especifique um nome para a implantação desse grupo de aplicativos.

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

-OverrideServiceWindow

De definir esse parâmetro $true para instalar o grupo de aplicativos fora de uma janela de manutenção.

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

-PersistOnWriteFilterDevice

Use este parâmetro para manipular filtros de gravação para Windows incorporados. Se você defini-lo como $true , o dispositivo confirma alterações no prazo ou durante uma janela de manutenção. Essa ação requer uma reinicialização. Se você defini-lo como , o dispositivo salvará alterações na sobreposição temporária e $false as confirma mais tarde.

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

-RebootOutsideServiceWindow

De definir esse parâmetro $true para permitir que o dispositivo seja reiniciado fora de uma janela de manutenção.

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

-SendWakeupPacket

Indica se um pacote de alerta deve ser enviado para computadores antes do início da implantação. Se esse valor for $True , o Configuration Manager acordará um computador do sono. Se esse valor for $False , ele não acordará computadores do sono. Para que os computadores acordem, primeiro configure Wake On LAN.

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

-TimeBaseOn

Especifique qual fuso horário usar:

• LocalTime: Use a hora local do dispositivo.
• UTC: Use UTC (Tempo Universal Coordenado).

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

-UseMeteredNetwork

Indica se é possível permitir que os clientes em uma conexão de Internet com metros baixem conteúdo após o prazo de instalação, o que pode incorrer em custos adicionais.

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

-UserNotification

Use este parâmetro para especificar a experiência do usuário para esta implantação:

• DisplayAll: Exibir no Centro de Software e mostrar todas as notificações
• DisplaySoftwareCenterOnly: Exibe no Centro de Software e mostra apenas notificações de reinicializações do computador.
• HideAll: Ocultar no Centro de Software e todas as notificações

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

-WhatIf

Mostrar o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

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

Entradas

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Saídas

IResultObject

Observações

Este cmdlet retorna o objeto SMS_ApplicationGroupAssignment classe WMI.

Links Relacionados

• Get-CMApplicationGroupDeployment
• Remove-CMApplicationGroupDeployment
• Set-CMApplicationGroupDeployment
• Get-CMApplicationGroup
• Criar grupos de aplicativos