Get-SCServicingWindow

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

Syntax

Connection (Default)

Get-SCServicingWindow
    [-VMMServer <ServerConnection>]
    [<CommonParameters>]

FromName

Get-SCServicingWindow
    [-Name] <String>
    [-VMMServer <ServerConnection>]
    [<CommonParameters>]

FromID

Get-SCServicingWindow
    -ID <Guid>
    [-VMMServer <ServerConnection>]
    [<CommonParameters>]

FromVMHost

Get-SCServicingWindow
    -VMHost <Host>
    [-VMMServer <ServerConnection>]
    [-ServicingWindowFilter <ServicingWindowFilterType>]
    [<CommonParameters>]

FromService

Get-SCServicingWindow
    -Service <Service>
    [-VMMServer <ServerConnection>]
    [-ServicingWindowFilter <ServicingWindowFilterType>]
    [<CommonParameters>]

FromVM

Get-SCServicingWindow
    -VM <VM>
    [-VMMServer <ServerConnection>]
    [-ServicingWindowFilter <ServicingWindowFilterType>]
    [<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.

Parameter properties

Type:Guid
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

FromID
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-Name

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

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

FromName
Position:0
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-Service

Specifies a VMM service object.

Parameter properties

Type:Service
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

FromService
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-ServicingWindowFilter

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

  • Now
  • Next
  • All

Parameter properties

Type:ServicingWindowFilterType
Default value:None
Accepted values:Now, Next, All
Supports wildcards:False
DontShow:False

Parameter sets

FromVMHost
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False
FromService
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False
FromVM
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-VM

Specifies a virtual machine object.

Parameter properties

Type:VM
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

FromVM
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments: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.

Parameter properties

Type:Host
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

FromVMHost
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-VMMServer

Specifies a VMM server object.

Parameter properties

Type:ServerConnection
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:True
Value from pipeline by property name:False
Value from remaining arguments:False

CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.

Outputs

ServicingWindow

This cmdlet returns a ServicingWindow object.