Compartilhar via

Add-SCServicingWindowSubscription

  • Referência
Módulo:
VirtualMachineManager

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

Syntax

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: assinar todas as máquinas virtuais pertencentes a um usuário específico a 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 de janela de manutenção chamado Preparo 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 pertencentes à Contoso\ReneeLo e armazena esses objetos na variável $VMs.

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

Exemplo 2: assinar todas as máquinas virtuais pertencentes a um usuário específico a 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 de 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 pertencentes à Contoso\ReneeLo e 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 a janela de manutenção armazenada em $SvcWindow.

Parâmetros

-JobVariable

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PROTipID

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

Type:Guid
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-RunAsynchronously

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Service

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

Type:Service
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ServicingWindow

Especifica um objeto de janela de manutenção.

Type:ServicingWindow
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-VM

Especifica um objeto de máquina virtual.

Type:VM
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-VMHost

Especifica um objeto 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 .

Type:Host
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

Saídas

ServicingWindowSubscription

Este cmdlet retorna um objeto ServicingWindowSubscription .