New-CMWindowsServicingPlan
SYNOPSIS
Cria um plano de manutenção Windows 10.
SYNTAX
Nome NewByCollection
New-CMWindowsServicingPlan -Name <String> [-Description <String>] -CollectionName <String> [-Enable <Boolean>]
[-SendWakeupPacket <Boolean>] [-VerboseLevel <VerboseLevelType>] [-Language <String[]>] [-Required <String[]>]
[-Title <String[]>] [-RunType <RunType>] [-Schedule <IResultObject>] [-UseUtc <Boolean>]
[-AvailableTime <Int32>] [-AvailableImmediately <Boolean>] [-AvailableTimeUnit <TimeUnitType>]
[-DeadlineImmediately <Boolean>] [-DeadlineTime <Int32>] [-DeadlineTimeUnit <TimeUnitType>]
[-UserNotification <UserNotificationType>] [-AllowSoftwareInstallationOutsideMaintenanceWindow <Boolean>]
[-AllowRestart <Boolean>] [-SuppressRestartServer <Boolean>] [-SuppressRestartWorkstation <Boolean>]
[-WriteFilterHandling <Boolean>] [-GenerateSuccessAlert <Boolean>] [-SuccessPercentage <Int32>]
[-AlertTime <Int32>] [-AlertTimeUnit <TimeUnitType>] [-DisableOperationManager <Boolean>]
[-GenerateOperationManagerAlert <Boolean>] [-NoInstallOnRemote <Boolean>] [-NoInstallOnUnprotected <Boolean>]
[-UseBranchCache <Boolean>] [-DownloadFromMicrosoftUpdate <Boolean>] [-AllowUseMeteredNetwork <Boolean>]
[-DeploymentPackage <IResultObject>] [-DownloadFromInternet <Boolean>] [-Location <String>]
[-DeploymentRing <DeploymentRing>] [-UpdateDeploymentWaitDay <Int32>] [-LanguageSelection <String[]>]
[-WhatIf] [-Confirm] [<CommonParameters>]
NewByCollection
New-CMWindowsServicingPlan -Name <String> [-Description <String>] -Collection <IResultObject>
[-Enable <Boolean>] [-SendWakeupPacket <Boolean>] [-VerboseLevel <VerboseLevelType>] [-Language <String[]>]
[-Required <String[]>] [-Title <String[]>] [-RunType <RunType>] [-Schedule <IResultObject>]
[-UseUtc <Boolean>] [-AvailableTime <Int32>] [-AvailableImmediately <Boolean>]
[-AvailableTimeUnit <TimeUnitType>] [-DeadlineImmediately <Boolean>] [-DeadlineTime <Int32>]
[-DeadlineTimeUnit <TimeUnitType>] [-UserNotification <UserNotificationType>]
[-AllowSoftwareInstallationOutsideMaintenanceWindow <Boolean>] [-AllowRestart <Boolean>]
[-SuppressRestartServer <Boolean>] [-SuppressRestartWorkstation <Boolean>] [-WriteFilterHandling <Boolean>]
[-GenerateSuccessAlert <Boolean>] [-SuccessPercentage <Int32>] [-AlertTime <Int32>]
[-AlertTimeUnit <TimeUnitType>] [-DisableOperationManager <Boolean>]
[-GenerateOperationManagerAlert <Boolean>] [-NoInstallOnRemote <Boolean>] [-NoInstallOnUnprotected <Boolean>]
[-UseBranchCache <Boolean>] [-DownloadFromMicrosoftUpdate <Boolean>] [-AllowUseMeteredNetwork <Boolean>]
[-DeploymentPackage <IResultObject>] [-DownloadFromInternet <Boolean>] [-Location <String>]
[-DeploymentRing <DeploymentRing>] [-UpdateDeploymentWaitDay <Int32>] [-LanguageSelection <String[]>]
[-WhatIf] [-Confirm] [<CommonParameters>]
NewByCollectionId
New-CMWindowsServicingPlan -Name <String> [-Description <String>] -CollectionId <String> [-Enable <Boolean>]
[-SendWakeupPacket <Boolean>] [-VerboseLevel <VerboseLevelType>] [-Language <String[]>] [-Required <String[]>]
[-Title <String[]>] [-RunType <RunType>] [-Schedule <IResultObject>] [-UseUtc <Boolean>]
[-AvailableTime <Int32>] [-AvailableImmediately <Boolean>] [-AvailableTimeUnit <TimeUnitType>]
[-DeadlineImmediately <Boolean>] [-DeadlineTime <Int32>] [-DeadlineTimeUnit <TimeUnitType>]
[-UserNotification <UserNotificationType>] [-AllowSoftwareInstallationOutsideMaintenanceWindow <Boolean>]
[-AllowRestart <Boolean>] [-SuppressRestartServer <Boolean>] [-SuppressRestartWorkstation <Boolean>]
[-WriteFilterHandling <Boolean>] [-GenerateSuccessAlert <Boolean>] [-SuccessPercentage <Int32>]
[-AlertTime <Int32>] [-AlertTimeUnit <TimeUnitType>] [-DisableOperationManager <Boolean>]
[-GenerateOperationManagerAlert <Boolean>] [-NoInstallOnRemote <Boolean>] [-NoInstallOnUnprotected <Boolean>]
[-UseBranchCache <Boolean>] [-DownloadFromMicrosoftUpdate <Boolean>] [-AllowUseMeteredNetwork <Boolean>]
[-DeploymentPackage <IResultObject>] [-DownloadFromInternet <Boolean>] [-Location <String>]
[-DeploymentRing <DeploymentRing>] [-UpdateDeploymentWaitDay <Int32>] [-LanguageSelection <String[]>]
[-WhatIf] [-Confirm] [<CommonParameters>]
DESCRIPTION
O cmdlet New-CMWindowsServicingPlan cria um plano de manutenção Windows 10.
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 um plano de manutenção por ID de recolha
PS XYZ:\> $Lang = ("Japanese", "English", "French")
PS XYZ:\> $Required = (">=1", "<=100")
PS XYZ:\> $Title = ("Title1", "Title2", "Title3")
PS XYZ:\> New-CMWindowsServicingPlan -Name "Test01" -CollectionId MP40001A -Description "Servicing Plan description01" -SendWakeupPacket $False -VerboseLevel AllMessages -Language $Lang -Required $Required -Title $Title -RunType DoNotRunThisRuleAutomatically -UseUtc $True -AvailableImmediately $True -DeadlineImmediately $False -UserNotification DisplayAll -AllowSoftwareInstallationOutsideMaintenanceWindow $True -AllowRestart $True -SuppressRestartServer $True -SuppressRestartWorkstation $True -DeploymentPackage (Get-CMSoftwareUpdateDeploymentPackage -Name "SUDP01")
O primeiro comando cria uma lista de línguas e armazena a lista na variável $Lang.
O segundo comando cria uma lista de cadeias de pesquisa e armazena a lista na variável $Required. Esta cadeia de pesquisa encontrará atualizações de software necessárias em pelo menos um computador e no máximo 100 computadores.
O terceiro comando cria uma lista de títulos de atualização de software e armazena a lista na variável $Title.
O último comando recebe o pacote de implementação de atualização de software chamado SUDP01 e, em seguida, cria um plano de manutenção Windows chamado Teste para a coleção-alvo com o ID MP40001A. O comando adiciona os idiomas de filtro de atualização armazenados em $Lang, o filtro necessário armazenado em $Required e o filtro de título de atualização de software armazenado em $Title.
Exemplo 2: Criar um plano de manutenção por nome de coleção
PS XYZ:\> $LangSelect = ("Japanese", "English", "French", "German")
PS XYZ:\> New-CMWindowsServicingPlan -Name "Test02" -CollectionName "ColName02" -DeploymentPackage (Get-CMSoftwareUpdateDeploymentPackage -Name "SUP02") -WriteFilterHandling $True -GenerateSuccessAlert $True -SuccessPercentage $True -AlertTime 10 -AlertTimeUnit Days -DisableOperationManager $True -GenerateOperationManagerAlert $True -NoInstallOnRemote $True -NoInstallOnUnprotected $True -UseBranchCache $True -DownloadFromMicrosoftUpdate $True -AllowUseMeteredNetwork $True -DownloadFromInternet $True -Location "\\TestSevr\WSUSTemp" -DeploymentRing Cbb -UpdateDeploymentWaitDay 20 -LanguageSelection $LangSelect
O primeiro comando cria uma lista de línguas de seleção de idiomas e armazena a lista na variável $LangSelect.
O segundo comando recebe o pacote de implementação de atualização de software chamado SUP02 e, em seguida, cria um plano de manutenção Windows chamado Test02 para a coleção-alvo chamada ColName02. O comando adiciona os idiomas selecionados por idiomas armazenados em $LangSelect.
PARAMETERS
-Hora do Alerta
Especifica um número inteiro compensado a partir de um prazo de implementação de atualização. A regra utiliza este valor para especificar quando a regra gera alertas. Especifique uma unidade de tempo utilizando o parâmetro AlertTimeUnit.
Type: Int32
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-AlertaTimeunit
Especifica uma unidade de tempo para o parâmetro AlertTime. 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
-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
Indica se permite que os clientes descarreguem conteúdo sobre uma ligação à Internet medido após o prazo, o que pode incorrer em despesas 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
Especifique quando as atualizações de software estão disponíveis.
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 o objeto de recolha do dispositivo alvo a utilizar para o plano de manutenção. Para obter um objeto de recolha do dispositivo, utilize os cmdletes Get-CMCollection ou Get-CMDeviceCollection.
Type: IResultObject
Parameter Sets: NewByCollection
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-CollectionId
Especifica a identificação da recolha do dispositivo-alvo a utilizar para o plano de manutenção.
Type: String
Parameter Sets: NewByCollectionId
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Nome de coleção
Especifica o nome da recolha do dispositivo-alvo a utilizar para o plano de manutenção.
Type: String
Parameter Sets: NewByCollectionName
Aliases:
Required: True
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
-DeploymentPackage
Especifica um pacote de implementação de atualização de software. Para obter um pacote de implementação de atualização de software, utilize o cmdlet Get-CMSoftwareUpdateDeploymentPackage.
Type: IResultObject
Parameter Sets: (All)
Aliases: InputObject
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Implantação
Especifica o estado de prontidão Windows a que o plano de manutenção deve ser aplicado. Os valores válidos são:
- CB
- Libertar
- BusinessMainstream
- Estação Cbb
- Ltsb
Type: DeploymentRing
Parameter Sets: (All)
Aliases:
Accepted values: CB, Release, BusinessMainstream, Cbb, Ltsb
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Descrição
Especifica uma descrição para o plano de manutenção.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DisableOperaçãoManager
Indica se desativar System Center alertas do Gestor de Operações durante as atualizações do software.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DownloadFromInternet
Indica se deve descarregar atualizações de software a partir da Internet.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DownloadFromMicrosoftUpdate
Indica se os computadores descarregam conteúdo do Microsoft Update se as atualizações de software não estiverem disponíveis num ponto de distribuição ou num ponto de distribuição remoto preferido.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Ativar
Indica se o plano de manutenção está ativado.
Type: Boolean
Parameter Sets: (All)
Aliases: Enabled, EnableDeployment
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Gerar OperationManagerAlert
Indica se gera alertas do Gestor de Operações durante uma atualização de software.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-GenerateSuccessAlert
Indica se deve gerar um alerta para uma implementação bem sucedida.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Língua
Especifica uma série de idiomas utilizados para filtrar atualizações de software que serão adicionadas ao plano de serviço.
Type: String[]
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Eleição linguística
Especifica uma variedade de línguas, como cordas. Os computadores descarregam as atualizações de software disponíveis nos idiomas especificados, além de atualizações não específicas da linguagem.
Type: String[]
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Localização
Especifica uma localização de rede para onde estão localizadas as atualizações descarregadas.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Name
Especifica um nome para o plano de manutenção. O nome deve ser único, ajudar a descrever o objetivo da regra, e identificá-lo de outros no site do Gestor de Configuração.
Type: String
Parameter Sets: (All)
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-NoInstallOnRemote
Indica se permite a instalação de atualizações em sistemas remotos. Se especificar um valor de $True, se o cliente estiver dentro de um limite de rede lento ou pouco fiável, ou quando o cliente utiliza uma localização de origem de retorno para o conteúdo, então o Gestor de Configuração não instala atualizações de software. Se especificar um valor de $False, a instalação prossegue.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-NoInstallOnInpretes
Indica se permite a instalação de atualizações em sistemas desprotegidos. Se especificar um valor de $True, se as atualizações de software não estiverem disponíveis em quaisquer pontos de distribuição preferidos, o Gestor de Configuração não descarrega e instala atualizações de software. Se especificar um valor de $False, a instalação prossegue.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Exigido
Especifica uma série de cadeias de pesquisa usadas para filtrar atualizações de software que serão adicionadas ao plano de serviço.
Type: String[]
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-RunType
Especifica o modo em que uma atualização é executado. Os valores válidos são:
- DoNotRunThisruleautomaticamente
- RunTheRuleAfterAnySoftwareUpdatePointSynchronization
- RunTheruleOnSchedule
Type: RunType
Parameter Sets: (All)
Aliases:
Accepted values: DoNotRunThisRuleAutomatically, RunTheRuleAfterAnySoftwareUpdatePointSynchronization, RunTheRuleOnSchedule
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Horário
Especifica o tempo de prazo (a partir do tempo disponível de implantação). Para criar um horário, utilize o cmdlet New-CMSchedule.
Type: IResultObject
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-SendWakeupPacket
Indica se deve enviar um pacote de despertar para os computadores antes do início da implantação. Se este valor for $True, o Gestor de Configuração acorda um computador do sono. Se este valor for $False, não acorda os computadores do sono. Para que os computadores acordem, primeiro tem de configurar Wake On LAN.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-SucessoPercentage
Especifica uma percentagem para a conformidade do cliente como um número inteiro de 0 a 99. Se a conformidade ficar abaixo desta percentagem, o Gestor de Configuração produz alertas opcionais.
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
-Título
Especifica uma série de cadeias de pesquisa usadas para filtrar títulos de atualização de software que serão adicionados ao plano de serviço.
Type: String[]
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-UpdateDeploymentWaitDay
Especifica o número de dias para esperar depois de a Microsoft ter publicado uma nova atualização antes de ser implementada no seu ambiente.
Type: Int32
Parameter Sets: (All)
Aliases: UpdateDeploymentWaitDays
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-UseBranchCache
Indica se deve usar uma cache de ramo. Se especificar um valor de $True, os clientes partilham o conteúdo 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: UserNotificationType
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 o nível de detalhe que pretende que os clientes reportem para implementações que esta regra cria. Os valores válidos são:
- AllMessages
- OnlyErrorMessages
- OnlySuccessAndErrorMessages
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.