New-CMAutoDeploymentRuleDeployment
SYNOPSIS
Criar uma implementação para uma regra de implantação automática.
SYNTAX
ByName (Padrão)
New-CMAutoDeploymentRuleDeployment [-AlertTime <Int32>] [-AlertTimeUnit <TimeUnitType>]
[-AllowDownloadFromMicrosoftUpdate <Boolean>] [-AllowRestart <Boolean>]
[-AllowSoftwareInstallationOutsideMaintenanceWindow <Boolean>] [-AllowUseMeteredNetwork <Boolean>]
[-AvailableImmediately <Boolean>] [-AvailableTime <Int32>] [-AvailableTimeUnit <TimeUnitType>]
[-Collection <IResultObject>] [-CollectionId <String>] [-CollectionName <String>]
[-DeadlineImmediately <Boolean>] [-DeadlineTime <Int32>] [-DeadlineTimeUnit <TimeUnitType>]
[-DisableOperationsManager <Boolean>] [-EnableDeployment <Boolean>]
[-GenerateOperationsManagerAlert <Boolean>] [-GenerateSuccessAlert <Boolean>] [-Name] <String>
[-NoInstallOnRemote <Boolean>] [-NoInstallOnUnprotected <Boolean>] [-RequirePostRebootFullScan <Boolean>]
[-SendWakeupPacket <Boolean>] [-SoftDeadlineEnabled <Boolean>] [-SuccessPercentage <Int32>]
[-SuppressRestartServer <Boolean>] [-SuppressRestartWorkstation <Boolean>] [-UseBranchCache <Boolean>]
[-UserNotification <UserNotificationOption>] [-UseUtc <Boolean>] [-VerboseLevel <VerboseLevelType>]
[-WriteFilterHandling <Boolean>] [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm]
[<CommonParameters>]
ById
New-CMAutoDeploymentRuleDeployment [-AlertTime <Int32>] [-AlertTimeUnit <TimeUnitType>]
[-AllowDownloadFromMicrosoftUpdate <Boolean>] [-AllowRestart <Boolean>]
[-AllowSoftwareInstallationOutsideMaintenanceWindow <Boolean>] [-AllowUseMeteredNetwork <Boolean>]
[-AvailableImmediately <Boolean>] [-AvailableTime <Int32>] [-AvailableTimeUnit <TimeUnitType>]
[-Collection <IResultObject>] [-CollectionId <String>] [-CollectionName <String>]
[-DeadlineImmediately <Boolean>] [-DeadlineTime <Int32>] [-DeadlineTimeUnit <TimeUnitType>]
[-DisableOperationsManager <Boolean>] [-EnableDeployment <Boolean>]
[-GenerateOperationsManagerAlert <Boolean>] [-GenerateSuccessAlert <Boolean>] [-Id] <Int32>
[-NoInstallOnRemote <Boolean>] [-NoInstallOnUnprotected <Boolean>] [-RequirePostRebootFullScan <Boolean>]
[-SendWakeupPacket <Boolean>] [-SoftDeadlineEnabled <Boolean>] [-SuccessPercentage <Int32>]
[-SuppressRestartServer <Boolean>] [-SuppressRestartWorkstation <Boolean>] [-UseBranchCache <Boolean>]
[-UserNotification <UserNotificationOption>] [-UseUtc <Boolean>] [-VerboseLevel <VerboseLevelType>]
[-WriteFilterHandling <Boolean>] [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm]
[<CommonParameters>]
ByValue
New-CMAutoDeploymentRuleDeployment [-AlertTime <Int32>] [-AlertTimeUnit <TimeUnitType>]
[-AllowDownloadFromMicrosoftUpdate <Boolean>] [-AllowRestart <Boolean>]
[-AllowSoftwareInstallationOutsideMaintenanceWindow <Boolean>] [-AllowUseMeteredNetwork <Boolean>]
[-AvailableImmediately <Boolean>] [-AvailableTime <Int32>] [-AvailableTimeUnit <TimeUnitType>]
[-Collection <IResultObject>] [-CollectionId <String>] [-CollectionName <String>]
[-DeadlineImmediately <Boolean>] [-DeadlineTime <Int32>] [-DeadlineTimeUnit <TimeUnitType>]
[-DisableOperationsManager <Boolean>] [-EnableDeployment <Boolean>]
[-GenerateOperationsManagerAlert <Boolean>] [-GenerateSuccessAlert <Boolean>] [-InputObject] <IResultObject>
[-NoInstallOnRemote <Boolean>] [-NoInstallOnUnprotected <Boolean>] [-RequirePostRebootFullScan <Boolean>]
[-SendWakeupPacket <Boolean>] [-SoftDeadlineEnabled <Boolean>] [-SuccessPercentage <Int32>]
[-SuppressRestartServer <Boolean>] [-SuppressRestartWorkstation <Boolean>] [-UseBranchCache <Boolean>]
[-UserNotification <UserNotificationOption>] [-UseUtc <Boolean>] [-VerboseLevel <VerboseLevelType>]
[-WriteFilterHandling <Boolean>] [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm]
[<CommonParameters>]
DESCRIPTION
O cmdlet Deployment New-CMAutoDeploymentRuleDeployment cria uma implementação para uma regra de implantação automática (ADR).
Nota
Executar cmdlets do Gestor de Configuração a partir da unidade do site do Gestor de Configuração, por exemplo PS XYZ:\> . Para mais informações, consulte a partida.
EXAMPLES
Exemplo 1: Criar uma implementação para uma regra de implantação automática por nome
Este comando cria uma implementação para a regra de implementação automática TestDepRule01 e a coleção All Systems.
New-CMAutoDeploymentRuleDeployment -Name "TestDepRule01" -CollectionName "All Systems" -EnableDeployment $true -SendWakeupPacket $false -VerboseLevel OnlySuccessAndErrorMessages -UseUtc $false -AvailableTime 7 -AvailableTimeUnit Days -DeadlineTime 7 -DeadlineTimeUnit Days -UserNotification DisplaySoftwareCenterOnly -AllowSoftwareInstallationOutsideMaintenanceWindow $false -AllowRestart $false -SuppressRestartServer $false -SuppressRestartWorkstation $false -WriteFilterHandling $false -GenerateSuccessAlert $true -SuccessPercentage 10 -AlertTime 7 -AlertTimeUnit Days -DisableOperationsManager $false -GenerateOperationsManagerAlert $false -NoInstallOnRemote $false -NoInstallOnUnprotected $false -UseBranchCache $false
Exemplo 2: Criar uma implementação para uma regra de implantação automática por objeto
Este comando obtém o objeto de regra de implantação automática chamado TestDepRule02. Em seguida, utiliza o operador do gasoduto para passar o objeto para New-CMAutoDeploymentRuleDeployment, que cria uma implementação para a regra de implantação automática TestDepRule02 e a coleção All Systems.
Get-CMAutoDeploymentRule -Name "TestDepRule02" | New-CMAutoDeploymentRuleDeployment -CollectionName "All Systems" -EnableDeployment $true -SendWakeupPacket $false -VerboseLevel OnlySuccessAndErrorMessages -UseUtc $false -AvailableTime 7 -AvailableTimeUnit Days -DeadlineTime 7 -DeadlineTimeUnit Days -UserNotification DisplaySoftwareCenterOnly -AllowSoftwareInstallationOutsideMaintenanceWindow $false -AllowRestart $false -SuppressRestartServer $false -SuppressRestartWorkstation $false -WriteFilterHandling $false -GenerateSuccessAlert $true -SuccessPercentage 10 -AlertTime 7 -AlertTimeUnit Days -DisableOperationsManager $false -GenerateOperationsManagerAlert $false -NoInstallOnRemote $false -NoInstallOnUnprotected $false -UseBranchCache $false
PARAMETERS
-Hora do Alerta
Especifica o número de unidades de tempo para a compensação a partir do prazo.
Type: Int32
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-AlertaTimeunit
Especifica o tipo de unidade de tempo para a compensação a partir do prazo.
Type: TimeUnitType
Parameter Sets: (All)
Aliases:
Accepted values: Hours, Days, Weeks, Months
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-PermitirDownloadFromMicrosoftUpdate
A partir da versão 1906, utilize este parâmetro para definir a seguinte opção na página de descarregamento Definições das definições de implementação ADR: Se as atualizações de software não estiverem disponíveis no ponto de distribuição em grupos de fronteira atuais, vizinhos ou locais, descarregue o conteúdo das atualizações do Microsoft.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-AllowRestart
Indica se é permitido reiniciar o sistema fora de quaisquer janelas de manutenção definidas quando o prazo de instalação for atingido.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Permitir instalação DesoftwareInstallOutsideMaintenanceWindow
Indica se a instalação do software pode ser realizada fora de quaisquer janelas de manutenção definidas quando o prazo de instalação for atingido.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Permitir a Rede De Mecânica de Uso
A partir da versão 1906, utilize este parâmetro para definir a seguinte opção na página de descarregamento Definições das definições de implementação ADR: Permitir que os clientes de uma ligação à Internet medido descarreguem conteúdo após o prazo de instalação, o que pode incorrer em custos adicionais
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DisponívelImmediadamente
Indica se as atualizações de software estão disponíveis para instalar o mais rapidamente possível após a execução da regra.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Tempo disponível
Especifica o número de unidades de tempo para o tempo disponível no software.
Type: Int32
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DisponívelTimeunit
Especifica o tipo de unidade de tempo para o software disponível.
Type: TimeUnitType
Parameter Sets: (All)
Aliases:
Accepted values: Hours, Days, Weeks, Months
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Coleção
Especifica um objeto de recolha de alvos para a implementação da atualização do software. Para obter um objeto de recolha, utilize o cmdlet Get-CMCollection.
Type: IResultObject
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-CollectionId
Especifica o ID da recolha do alvo para a implementação da atualização do software.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Nome de coleção
Especifica o nome da recolha do alvo para a implementação da atualização do software.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Confirm
Solicita a sua confirmação antes de executar o cmdlet.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: cf
Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
-DeadlineImmediatemente
Indica se as atualizações de software necessárias são instaladas o mais rapidamente possível quando o prazo é atingido.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DeadlineTime
Especifica o número de unidades de tempo para o prazo.
Type: Int32
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DeadlineTimeUnit
Especifica o tipo de unidade de tempo para o prazo.
Type: TimeUnitType
Parameter Sets: (All)
Aliases:
Accepted values: Hours, Days, Weeks, Months
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DisableOperationsManager
Indica se os alertas do Gestor de Operações são desativado enquanto as atualizações de software são executadas.
Type: Boolean
Parameter Sets: (All)
Aliases: DisableOperationManager
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DisableWildcardHandling
Este parâmetro trata os caracteres wildcard como valores de caracteres literais. Não pode combiná-lo com ForceWildcardHandling.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Ativar a deploração
Indica se ativa a implementação após a execução desta regra para o grupo de software associado. Se estiver $False definido, desloque manualmente o grupo de atualização de software.
Type: Boolean
Parameter Sets: (All)
Aliases: Enable, EnabledAfterCreate, EnableAfterCreate
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ForceWildcardHandling
Este parâmetro processa caracteres wildcard e pode levar a um comportamento inesperado (não recomendado). Não é possível combiná-lo com DisableWildcardHandling.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Gerar OperaçõesManagerAlert
Indica se os alertas do Gestor de Operações são gerados quando uma instalação de atualização de software falha.
Type: Boolean
Parameter Sets: (All)
Aliases: GenerateOperationManagerAlert
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-GenerateSuccessAlert
Indica se um alerta é gerado quando esta regra é executado com sucesso.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
- ID
Especifica o ID da regra de implantação automática para adicionar esta implementação.
Type: Int32
Parameter Sets: ById
Aliases: AutoDeploymentID
Required: True
Position: 0
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-InputObject
Especifica um objeto de regra de implantação automática para adicionar esta implementação. Para obter um objeto de regra de implantação automática, utilize o cmdlet Get-CMSoftwareUpdateAutoDeploymentRule.
Type: IResultObject
Parameter Sets: ByValue
Aliases: AutoDeploymentRule
Required: True
Position: 0
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False
-Name
Especifica o nome da regra de implantação automática para adicionar esta implementação.
Type: String
Parameter Sets: ByName
Aliases: AutoDeploymentName
Required: True
Position: 0
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-NoInstallOnRemote
Indica se deve instalar atualizações de software quando as atualizações não estão disponíveis em quaisquer pontos de distribuição remota.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-NoInstallOnInpretes
Indica se deve instalar atualizações de software quando as atualizações não estão disponíveis em quaisquer pontos de distribuição desprotegidos.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-RequirePostRebootFullScan
A partir da versão 1906, utilize este parâmetro para definir a seguinte opção na página Experiência do Utilizador das definições de implementação ADR: Se qualquer atualização nesta implementação exigir um reinício do sistema, executar atualizações do ciclo de avaliação da implementação após o reinício.
Type: Boolean
Parameter Sets: (All)
Aliases: RunEvaluationAfterRestart
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-SendWakeupPacket
Indica se deve utilizar o Wake-on-LAN para acordar os clientes para as implementações necessárias.
Type: Boolean
Parameter Sets: (All)
Aliases: EnableWakeOnLan
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-SoftDeadlineEnabled
A partir da versão 1906, utilize este parâmetro para definir a seguinte opção na página de Agenda de Implementação das definições de implementação ADR: Adiar a execução desta implementação de acordo com as preferências do utilizador, até ao período de carência definido nas definições do cliente.
Type: Boolean
Parameter Sets: (All)
Aliases: DelayEnforcementAndUpToGracePeriod
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-SucessoPercentage
Especifica a percentagem como um número inteiro de conformidade com o cliente. Quando a conformidade do cliente fica abaixo desta percentagem, é gerado um alerta.
Type: Int32
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-SupressorrartServer
Indica se um reinício do sistema é suprimido nos servidores quando uma atualização de software requer um reinício do sistema para concluir o processo de instalação.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-SupressorartWorkstation
Indica se um reinício do sistema é suprimido em estações de trabalho quando uma atualização de software requer um reinício do sistema para concluir o processo de instalação.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-UseBranchCache
Indica se os clientes estão autorizados a partilhar conteúdo com outros clientes na mesma sub-rede.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-UseUtc
Indica se o calendário para esta implantação é avaliado com base no Tempo Coordenado Universal (UTC).
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Notificação do Utilizador
Especifica o comportamento de notificação da experiência visual do utilizador.
Type: UserNotificationOption
Parameter Sets: (All)
Aliases:
Accepted values: DisplayAll, DisplaySoftwareCenterOnly, HideAll
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-VerboseLevel
Especifica quanto detalhe do estado os clientes reportam para implementações criadas por esta regra.
Type: VerboseLevelType
Parameter Sets: (All)
Aliases:
Accepted values: OnlyErrorMessages, OnlySuccessAndErrorMessages, AllMessages
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
- O QueIf
Apresenta o que aconteceria mediante a execução do cmdlet. O comandante não funciona.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: wi
Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
-WriteFilterHandling
Indica se as alterações são cometidas no prazo ou durante uma janela de manutenção (requer o reinício). Se definido para $False , o conteúdo é aplicado na sobreposição e cometido mais tarde.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
CommonParameters
Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction e -WarningVariable. Para mais informações, consulte about_CommonParameters.
INPUTS
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
OUTPUTS
IResultObject#SMS_AdrDeploymentSettings
NOTAS
RELATED LINKS
Get-CMAutoDeploymentRuleDeployment