Set-CMAutoDeploymentRuleDeployment
SYNOPSIS
Define uma implementação para uma regra de implantação automática.
SYNTAX
ByValue (Padrão)
Set-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>] [-PassThru]
[-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
Set-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>] [-PassThru]
[-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 Set-CMAutoDeploymentRuleDeployment cmdlet atualiza uma implementação para uma regra de implantação automática.
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: Definir uma implementação por ID
PS XYZ:\> Set-CMAutoDeploymentRuleDeployment -ID 348 -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
Este comando atualiza as definições para a implementação da regra de implantação com o ID de ação de 348 e a coleção chamada Todos os Sistemas.
Exemplo 2: Definir uma implementação usando uma variável
PS XYZ:\> $ReferenceADR = Get-CMAutoDeploymentRule -Name "TestADR01"
PS XYZ:\> $Deployment = $ReferenceADR | Get-CMAutoDeploymentRuleDeployment
PS XYZ:\> Set-CMAutoDeploymentRuleDeployment -InputObject $Deployment[0] -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
O primeiro comando obtém o objeto de regra de implantação automática chamado TestADR01 e armazena o objeto na variável $ReferenceADR.
O segundo comando obtém as implementações associadas ao objeto de regra de implantação automática armazenado em $ReferenceADR e armazena as implementações na variável $Deployment.
O último comando atualiza as definições da primeira implantação armazenada em $Deployment.
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. Os valores válidos são:
- Horas
- Dias
- Semanas
- Meses
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. Os valores válidos são:
- Horas
- Dias
- Semanas
- Meses
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. Os valores válidos são:
- Horas
- Dias
- Semanas
- Meses
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 definido para $False, deve implementar 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 de ação da implementação automática da regra de implantação.
Type: Int32
Parameter Sets: ById
Aliases: ActionID
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 obter um objeto de regra de implantação automática, utilize o cmdlet Get-CMSoftwareUpdateAutoDeploymentRule.
Type: IResultObject
Parameter Sets: ByValue
Aliases: AutoDeploymentRuleDeployment
Required: True
Position: 0
Default value: None
Accept pipeline input: True (ByValue)
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
- PassThru
Adicione este parâmetro para devolver um objeto que represente o item com o qual está a trabalhar. Por predefinição, este cmdlet pode não gerar qualquer saída.
Type: SwitchParameter
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, da 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. Os valores válidos são:
- DisplayAll
- DisplaySoftwareCenterOnly
- HideAll
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. Os valores válidos são:
- OnlyErrorMessages
- OnlySuccessAndErrorMessages
- AllMessages
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
Get-CMSoftwareUpdateAutoDeploymentRule