New-CMWindowsServicingPlan
Cria um plano de manutenção Windows 10.
Syntax
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>]
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>]
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.
Observação
Execute Configuration Manager cmdlets da unidade do site Configuration Manager, por exemplo PS XYZ:\>
. Para obter mais informações, confira introdução.
Exemplos
Exemplo 1: Criar um plano de manutenção por ID da coleção
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 idiomas e armazena a lista na variável $Lang.
O segundo comando cria uma lista de cadeias de caracteres de pesquisa e armazena a lista na variável $Required. Essa cadeia de caracteres 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 obtém o pacote de implantação de atualização de software chamado SUDP01 e cria um plano de manutenção do Windows chamado Teste para a coleção de destino com a 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 da 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 idiomas de seleção de idiomas e armazena a lista na variável $LangSelect.
O segundo comando obtém o pacote de implantação de atualização de software chamado SUP02 e cria um plano de manutenção do Windows chamado Test02 para a coleção de destino chamada ColName02. O comando adiciona o idioma selecionar idiomas armazenados em $LangSelect.
Parâmetros
-AlertTime
Especifica um deslocamento inteiro de um prazo de implantação de atualização. A regra usa esse valor para especificar quando a regra gera alertas. Especifique uma unidade de tempo usando o parâmetro AlertTimeUnit .
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AlertTimeUnit
Especifica uma unidade de tempo para o parâmetro AlertTime . Os valores válidos são:
- Horas
- Dias
- Semanas
- Meses
Type: | TimeUnitType |
Accepted values: | Hours, Days, Weeks, Months |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AllowRestart
Indica se uma reinicialização do sistema pode ser executada fora de qualquer janela de manutenção definida quando o prazo de instalação for atingido.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AllowSoftwareInstallationOutsideMaintenanceWindow
Indica se a instalação de software pode ser executada fora de qualquer janela de manutenção definida quando o prazo de instalação for atingido.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AllowUseMeteredNetwork
Indica se é necessário permitir que os clientes baixem conteúdo em uma conexão de Internet limitada após o prazo, o que pode incorrer em despesas adicionais.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AvailableImmediately
Indica se as atualizações de software estão disponíveis para instalação o mais rápido possível após a execução da regra.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AvailableTime
Especifique quando as atualizações de software estiverem disponíveis.
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AvailableTimeUnit
Especifica o tipo de unidade de tempo para o tempo disponível do software. Os valores válidos são:
- Horas
- Dias
- Semanas
- Meses
Type: | TimeUnitType |
Accepted values: | Hours, Days, Weeks, Months |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Collection
Especifica o objeto de coleção de dispositivos de destino a ser usado para o plano de manutenção. Para obter um objeto de coleção de dispositivos, use os cmdlets Get-CMCollection ou Get-CMDeviceCollection .
Type: | IResultObject |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CollectionId
Especifica a ID da coleção de dispositivos de destino a ser usada para o plano de manutenção.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CollectionName
Especifica o nome da coleção de dispositivos de destino a ser usada para o plano de manutenção.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
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: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DeadlineImmediately
Indica se as atualizações de software necessárias são instaladas o mais rápido possível quando o prazo é atingido.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DeadlineTime
Especifica o número de unidades de tempo para o prazo.
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DeadlineTimeUnit
Especifica o tipo de unidade de hora para o prazo. Os valores válidos são:
- Horas
- Dias
- Semanas
- Meses
Type: | TimeUnitType |
Accepted values: | Hours, Days, Weeks, Months |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DeploymentPackage
Especifica um pacote de implantação de atualização de software. Para obter um pacote de implantação de atualização de software, use o cmdlet Get-CMSoftwareUpdateDeploymentPackage .
Type: | IResultObject |
Aliases: | InputObject |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DeploymentRing
Especifica o estado de preparação do Windows ao qual o plano de manutenção deve ser aplicado. Os valores válidos são:
- CB
- Liberar
- BusinessMainstream
- Cbb
- Ltsb
Type: | DeploymentRing |
Accepted values: | CB, Release, BusinessMainstream, Cbb, Ltsb |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Description
Especifica uma descrição do plano de manutenção.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DisableOperationManager
Indica se deve desabilitar alertas do System Center Operations Manager durante atualizações de software.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DownloadFromInternet
Indica se é necessário baixar atualizações de software da Internet.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DownloadFromMicrosoftUpdate
Indica se os computadores baixam conteúdo do Microsoft Update se as atualizações de software não estiverem disponíveis em um ponto de distribuição preferencial ou ponto de distribuição remota.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Enable
Indica se o plano de manutenção está habilitado.
Type: | Boolean |
Aliases: | Enabled, EnableDeployment |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-GenerateOperationManagerAlert
Indica se deve gerar alertas do Operations Manager durante uma atualização de software.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-GenerateSuccessAlert
Indica se deve gerar um alerta para implantação bem-sucedida.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Language
Especifica uma matriz de idiomas usada para filtrar atualizações de software que serão adicionadas ao plano de serviço.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-LanguageSelection
Especifica uma matriz de idiomas, como cadeias de caracteres. Os computadores baixam atualizações de software disponíveis nos idiomas especificados, além de atualizações não específicas do idioma.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Location
Especifica um local de rede para onde as atualizações baixadas estão localizadas.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Name
Especifica um nome para o plano de manutenção. O nome deve ser exclusivo, ajudar a descrever o objetivo da regra e identificá-la de outras pessoas no site Configuration Manager.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-NoInstallOnRemote
Indica se é possível permitir a instalação de atualizações em sistemas remotos. Se você especificar um valor de $True, se o cliente estiver dentro de um limite de rede lento ou não confiável ou quando o cliente usar um local de origem de fallback para conteúdo, Configuration Manager não instalará atualizações de software. Se você especificar um valor de $False, a instalação continuará.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-NoInstallOnUnprotected
Indica se é possível permitir a instalação de atualizações em sistemas desprotegidos. Se você especificar um valor de $True, se as atualizações de software não estiverem disponíveis em nenhum ponto de distribuição preferencial, Configuration Manager não baixará e instalará atualizações de software. Se você especificar um valor de $False, a instalação continuará.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Required
Especifica uma matriz de cadeias de caracteres de pesquisa usadas para filtrar atualizações de software que serão adicionadas ao plano de serviço.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RunType
Especifica o modo no qual uma atualização é executada. Os valores válidos são:
- DoNotRunThisRuleAutomatically
- RunTheRuleAfterAnySoftwareUpdatePointSynchronization
- RunTheRuleOnSchedule
Type: | RunType |
Accepted values: | DoNotRunThisRuleAutomatically, RunTheRuleAfterAnySoftwareUpdatePointSynchronization, RunTheRuleOnSchedule |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Schedule
Especifica o tempo de prazo (da implantação do tempo disponível). Para criar uma agenda, use o cmdlet New-CMSchedule .
Type: | IResultObject |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SendWakeupPacket
Indica se é necessário enviar um pacote de despertar para computadores antes do início da implantação. Se esse valor for $True, Configuration Manager acordará um computador do sono. Se esse valor for $False, ele não acordará os computadores do sono. Para que os computadores ativem, primeiro você deve configurar o Wake On LAN.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SuccessPercentage
Especifica uma porcentagem para a conformidade do cliente como um inteiro de 0 a 99. Se a conformidade estiver abaixo desse percentual, Configuration Manager produzirá alertas opcionais.
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SuppressRestartServer
Indica se uma reinicialização do sistema é suprimida em servidores quando uma atualização de software requer uma reinicialização do sistema para concluir o processo de instalação.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SuppressRestartWorkstation
Indica se uma reinicialização do sistema é suprimida em estações de trabalho quando uma atualização de software requer uma reinicialização do sistema para concluir o processo de instalação.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Title
Especifica uma matriz de cadeias de caracteres de pesquisa usadas para filtrar títulos de atualização de software que serão adicionados ao plano de serviço.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UpdateDeploymentWaitDay
Especifica o número de dias para aguardar depois que a Microsoft publicou uma nova atualização antes de implantar em seu ambiente.
Type: | Int32 |
Aliases: | UpdateDeploymentWaitDays |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UseBranchCache
Indica se deve usar um cache de branch. Se você especificar um valor de $True, os clientes compartilharão conteúdo na mesma sub-rede.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UserNotification
Especifica o comportamento de notificação da experiência visual do usuário. Os valores válidos são:
- DisplayAll
- DisplaySoftwareCenterOnly
- HideAll
Type: | UserNotificationType |
Accepted values: | DisplayAll, DisplaySoftwareCenterOnly, HideAll |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UseUtc
Indica se o agendamento dessa implantação é avaliado com base no UTC (Tempo Coordenado Universal).
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-VerboseLevel
Especifica o nível de detalhes que você deseja que os clientes reportem para implantações que essa regra cria. Os valores válidos são:
- AllMessages
- OnlyErrorMessages
- OnlySuccessAndErrorMessages
Type: | VerboseLevelType |
Accepted values: | OnlyErrorMessages, OnlySuccessAndErrorMessages, AllMessages |
Position: | Named |
Default value: | None |
Required: | False |
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: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WriteFilterHandling
Indica se as alterações são confirmadas no prazo ou durante uma janela de manutenção (requer reinicializações). Se definido como $False, o conteúdo será aplicado na sobreposição e confirmado posteriormente.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Entradas
None
Saídas
System.Object
Links Relacionados
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de