Partager via

Add-SCServicingWindowSubscription

  • Référence
Module:
VirtualMachineManager

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

Syntaxe

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

La Add-SCServicingWindowSubscription cmdlet 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 détenues par 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 : Abonnez 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 détenues par Contoso\ReneeLo, puis utilise l’opérateur de pipeline pour transmettre les machines virtuelles au Add-SCServicingWindowSubscription cmdlet, qui s’abonne à chaque machine virtuelle transmise à la fenêtre de maintenance stockée dans $SvcWindow.

Paramètres

-JobVariable

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

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-PROTipID

Spécifie l’ID de l’info-bulle d’optimisation des performances et des ressources (CONSEIL PRO) qui a déclenché cette action. Ce paramètre vous permet d’auditer les conseils pro.

Type:Guid
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-RunAsynchronously

Indique que le travail s’exécute de façon asynchrone afin que le contrôle retourne immédiatement à l’interpréteur de commandes.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Service

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

Type:Service
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-ServicingWindow

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

Type:ServicingWindow
Position:0
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-VM

Spécifie un objet de machine virtuelle.

Type:VM
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-VMHost

Spécifie un objet hôte de machine virtuelle. 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
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

Sorties

ServicingWindowSubscription

Cette applet de commande retourne un objet ServicingWindowSubscription.