Partager via

Add-SCServicingWindowSubscription

  • Référence
Module:
VirtualMachineManager

Ajoute une fenêtre de maintenance à une machine virtuelle, un hôte ou un service.

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

L’applet de commande Add-SCServicingWindowSubscription ajoute une fenêtre de maintenance à une machine virtuelle, un hôte ou un service. Une fois qu’une fenêtre de maintenance est affectée à un objet, les utilisateurs peuvent planifier le travail de maintenance à effectuer dans la fenêtre de maintenance à l’aide d’un système de planification tiers.

Exemples

Exemple 1 : Abonner toutes les machines virtuelles appartenant à un utilisateur spécifique à une fenêtre de maintenance

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

La première commande obtient l’objet de fenêtre de maintenance nommé Backup Staging A et stocke l’objet dans la variable $SvcWindow.

La deuxième commande obtient tous les objets de machine virtuelle, sélectionne uniquement les machines virtuelles appartenant à Contoso\ReneeLo, puis stocke ces objets dans la variable $VMs.

La dernière commande abonne les machines virtuelles stockées dans $VMs à la fenêtre de maintenance stockée dans $SvcWindow.

Exemple 2 : Abonner toutes les machines virtuelles appartenant à un utilisateur spécifique à une fenêtre de maintenance à l’aide de l’opérateur 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

La première commande obtient l’objet de fenêtre de maintenance nommé Test Servers Group 3 et stocke l’objet dans la variable $SvcWindow.

La deuxième commande obtient tous les objets de machine virtuelle, sélectionne uniquement les machines virtuelles appartenant à Contoso\ReneeLo, puis utilise l’opérateur de pipeline pour transmettre les machines virtuelles à l’applet de commande Add-SCServicingWindowSubscription , qui s’abonne à chaque machine virtuelle qui est transmise à la fenêtre de maintenance stockée dans $SvcWindow.

Paramètres

-JobVariable

Spécifie que la progression des travaux est suivie et stockée dans la variable nommée par ce paramètre.

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

-PROTipID

Spécifie l’ID du conseil d’optimisation des performances et des ressources qui a déclenché cette action. Ce paramètre vous permet d’auditer les conseils PRO.

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

-RunAsynchronously

Indique que le travail s’exécute de manière asynchrone afin que le contrôle retourne immédiatement à l’interpréteur de commandes.

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

-Service

Spécifie un objet de service VMM (Virtual Machine Manager).

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

-ServicingWindow

Spécifie un objet de fenêtre de maintenance.

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

-VM

Spécifie un objet ordinateur virtuel.

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

-VMHost

Spécifie un objet ordinateur hôte d’ordinateur virtuel. VMM prend en charge les hôtes Hyper-V, les hôtes VMware ESX et les hôtes Citrix XenServer.

Pour plus d’informations sur chaque type d’hôte, consultez l’applet de commande Add-SCVMHost .

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

Sorties

ServicingWindowSubscription

Cette applet de commande retourne un objet ServicingWindowSubscription .