Partilhar 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 serviç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 pertencentes a 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 Backup Staging 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 são de propriedade de Contoso\ReneeLo e armazena esses objetos na variável $VMs.

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

Exemplo 2: Inscrever todas as máquinas virtuais pertencentes a 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 serviço chamado Test Servers Group 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 a Contoso\ReneeLo e, em seguida, usa o operador de pipeline para passar as máquinas virtuais para o cmdlet Add-SCServicingWindowSubscription , que inscreve cada máquina virtual que é passada para ela na janela de serviço armazenada no $SvcWindow.

Parâmetros

-JobVariable

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

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-PROTipID

Especifica a ID da dica de Otimização de Desempenho e Recursos (dica PRO) que disparou essa ação. Este parâmetro permite auditar dicas PRO.

Tipo:Guid
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-RunAsynchronously

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

Tipo:SwitchParameter
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Service

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

Tipo:Service
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-ServicingWindow

Especifica um objeto de janela de manutenção.

Tipo:ServicingWindow
Position:0
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-VM

Especifica um objeto de máquina virtual.

Tipo:VM
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-VMHost

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

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

Tipo:Host
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

Saídas

ServicingWindowSubscription

Este cmdlet retorna um objeto ServicingWindowSubscription.