Get-SCServicingWindowSubscription

Gets a list of servicing window subscriptions.

Syntax

Get-SCServicingWindowSubscription [[-ServicingWindow] <ServicingWindow>] -Service <Service>
 [-VMMServer <ServerConnection>] [<CommonParameters>]
Get-SCServicingWindowSubscription [[-ServicingWindow] <ServicingWindow>] -VM <VM>
 [-VMMServer <ServerConnection>] [<CommonParameters>]
Get-SCServicingWindowSubscription [[-ServicingWindow] <ServicingWindow>] -VMHost <Host>
 [-VMMServer <ServerConnection>] [<CommonParameters>]

Description

The Get-SCServicingWindowSubscription cmdlet gets a list of servicing window subscriptions.

Examples

Example 1: Get a list of servicing window subscriptions for a virtual machine

PS C:\> $VM = Get-SCVirtualMachine -Name "VM01"
PS C:\> $SvcWindowSub = Get-SCServicingWindowSubscription -VM $VM
PS C:\> $SvcWindowSub

The first command gets the virtual machine object named VM01 and stores the object in the $VM variable.

The second command gets the servicing window subscription objects for the virtual machine stored in $VM (VM01) and stores the objects in the $SvcWindowSub variable.

The last command displays the servicing windows stored in $SvcWindowSub for the user.

Example 2: Get a list of subscriptions for a specified servicing window

PS C:\> $SvcWindow = Get-SCServicingWindow -Name "Backup Staging A"
PS C:\> $SvcWindowSub = Get-SCServicingWindowSubscription -ServicingWindow $SvcWindow
PS C:\> $SvcWindowSub

The first command gets the servicing window object named Backup Staging A and stores the object in the $SvcWindow variable.

The second command gets the servicing window subscription objects for the servicing window stored in $SvcWindow (Backup Staging A) and stores the objects in the $SvcWindowSub variable.

The last command displays the list of subscriptions stored in $SvcWindowSub to the user.

Example 3: Get the servicing window subscription for a specified virtual machine and a specified servicing window

PS C:\> $VM = Get-VM -Name "VM01"
PS C:\> $SvcWindow = Get-SCServicingWindow -Name "Backup Staging A"
PS C:\> $SvcWindowSub = Get-SCServicingWindowSubscription -VM $VM -ServicingWindow $SvcWindow 
PS C:\> $SvcWindowSub

The first command gets the virutal machine object named VM01 and stores the object in the $VM variable.

The second command gets the servicing window object named Backup Staging A and stores the object in the $SvcWindow variable.

The third command gets the servicing window subscription object for the virtual machine stored in $VM (VM01) and the servicing window stored in $SvcWindow (Backup Staging A) and stores the object in the $SvcWindowSub variable.

The last command displays information about the servicing window subscription stored in $SvcWindowSub to the user.

Parameters

-Service

Specifies a Virtual Machine Manager (VMM) service object.

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

Specifies a servicing window object.

Type:ServicingWindow
Required:False
Position:0
Default value:None
Accept pipeline input:True (ByValue)
Accept wildcard characters:False
-VM

Specifies a virtual machine object.

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

Specifies a virtual machine host object. VMM supports Hyper-V hosts, VMware ESX hosts, and Citrix XenServer hosts.

For more information about each type of host, see the Add-SCVMHost cmdlet.

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

Specifies a VMM server object.

Type:ServerConnection
Required:False
Position:Named
Default value:None
Accept pipeline input:True (ByValue)
Accept wildcard characters:False

Outputs

ServicingWindowSubscription

This cmdlet returns a **ServicingWindowSubscription** object.