Compartilhar via

Add-SCServicingWindowSubscription

  • Referência
Módulo:
VirtualMachineManager

Adiciona uma janela de manutenção a uma máquina virtual, host ou serviço.

Sintaxe

Add-SCServicingWindowSubscription
   [-ServicingWindow] <ServicingWindow>
   -VM <VM>
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]
Add-SCServicingWindowSubscription
   [-ServicingWindow] <ServicingWindow>
   -VMHost <Host>
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]
Add-SCServicingWindowSubscription
   [-ServicingWindow] <ServicingWindow>
   -Service <Service>
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]

Description

O cmdlet Add-SCServicingWindowSubscription adiciona uma janela de manutenção a uma máquina virtual, host ou serviço. Depois que uma janela de manutenção é atribuída a um objeto, os usuários podem agendar o trabalho de manutenção a ser feito dentro da janela de manutenção usando um sistema de agendamento de terceiros.

Exemplos

Exemplo 1: inscrever todas as máquinas virtuais de propriedade de um usuário específico em uma janela de manutenção

PS C:\> $SvcWindow = Get-SCServicingWindow -Name "Backup Staging A"
PS C:\> $VMs = Get-SCVirtualMachine | where {$_.Owner -eq "Contoso\ReneeLo"} 
PS C:\> Add-SCServicingWindowSubscription -ServicingWindow $SvcWindow -VM $VMs

O primeiro comando obtém o objeto da janela de manutenção chamado Preparação de Backup A e armazena o objeto na variável $SvcWindow.

O segundo comando obtém todos os objetos de máquina virtual, seleciona apenas as máquinas virtuais que pertencem à Contoso\ReneeLo e armazena esses objetos na variável $VMs.

O último comando assina as máquinas virtuais armazenadas em $VMs à janela de manutenção armazenada em $SvcWindow.

Exemplo 2: inscrever todas as máquinas virtuais de propriedade de um usuário específico em uma janela de manutenção usando o operador de pipeline

PS C:\> $SvcWindow = Get-SCServicingWindow -Name "Test Servers Group 3"
PS C:\> Get-SCVirtualMachine | where {$_.Owner -eq "Contoso\NevenSokec"} | Add-SCServicingWindowSubscription -ServicingWindow $SvcWindow

O primeiro comando obtém o objeto da janela de manutenção chamado Grupo de Servidores de Teste 3 e armazena o objeto na variável $SvcWindow.

O segundo comando obtém todos os objetos de máquina virtual, seleciona apenas as máquinas virtuais que pertencem à Contoso\ReneeLo e, em seguida, usa o operador de pipeline para passar as máquinas virtuais para o cmdlet Add-SCServicingWindowSubscription , que assina cada máquina virtual que é passada para ela para a janela de manutenção armazenada em $SvcWindow.

Parâmetros

-JobVariable

Especifica que o progresso do trabalho é acompanhado e armazenado na variável nomeada por esse parâmetro.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-PROTipID

Especifica a ID da dica de Otimização de Recursos e Desempenho (dica PRO) que disparou essa ação. Esse parâmetro permite que você audite dicas pro.

Tipo:Guid
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-RunAsynchronously

Indica que o trabalho é executado de forma assíncrona para que o controle retorne ao shell de comando imediatamente.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Service

Especifica um objeto de serviço do VMM (Virtual Machine Manager).

Tipo:Service
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-ServicingWindow

Especifica um objeto de janela de manutenção.

Tipo:ServicingWindow
Cargo:0
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-VM

Especifica um objeto de máquina virtual.

Tipo:VM
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-VMHost

Especifica um objeto de host de máquina virtual. O VMM dá suporte a hosts Hyper-V, hosts VMware ESX e hosts Citrix XenServer.

Para obter mais informações sobre cada tipo de host, consulte o cmdlet Add-SCVMHost.

Tipo:Host
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

Saídas

ServicingWindowSubscription

Esse cmdlet retorna um objeto ServicingWindowSubscription.