Share via

Get-SCServicingWindow

  • Reference
Module:
VirtualMachineManager

Gets a list of servicing windows that are assigned to a virtual machine, a host, or a service.

Syntax

Get-SCServicingWindow
   [-VMMServer <ServerConnection>]
   [<CommonParameters>]
Get-SCServicingWindow
   [-VMMServer <ServerConnection>]
   [-Name] <String>
   [<CommonParameters>]
Get-SCServicingWindow
   [-VMMServer <ServerConnection>]
   -ID <Guid>
   [<CommonParameters>]
Get-SCServicingWindow
   [-VMMServer <ServerConnection>]
   [-ServicingWindowFilter <ServicingWindowFilterType>]
   -VMHost <Host>
   [<CommonParameters>]
Get-SCServicingWindow
   [-VMMServer <ServerConnection>]
   [-ServicingWindowFilter <ServicingWindowFilterType>]
   -Service <Service>
   [<CommonParameters>]
Get-SCServicingWindow
   [-VMMServer <ServerConnection>]
   [-ServicingWindowFilter <ServicingWindowFilterType>]
   -VM <VM>
   [<CommonParameters>]

Description

The Get-SCServicingWindow cmdlet gets a list of servicing windows that are assigned to a virtual machine, a host, or a service.

Examples

Example 1: Get a specific servicing window by its name

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

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

The second command displays the information about the servicing window stored in $SvcWindow (Backup Staging A).

Parameters

-ID

Specifies the numerical identifier as a globally unique identifier, or GUID, for a specific object.

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

-Name

Specifies the name of a Virtual Machine Manager (VMM) object.

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

-Service

Specifies a VMM service object.

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

-ServicingWindowFilter

Specifies a filter for retrieving servicing windows. Valid values are:

  • Now
  • Next
  • All
Type:ServicingWindowFilterType
Accepted values:Now, Next, All
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-VM

Specifies a virtual machine object.

Type:VM
Position:Named
Default value:None
Required:True
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
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-VMMServer

Specifies a VMM server object.

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

Outputs

ServicingWindow

This cmdlet returns a ServicingWindow object.