Share via

Get-SCServiceConfiguration

  • Reference
Module:
VirtualMachineManager

Gets a service configuration object stored in the VMM library.

Syntax

Get-SCServiceConfiguration
   [-VMMServer <ServerConnection>]
   [-Name <String>]
   [-ID <Guid>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]

Description

The Get-SCServiceConfiguration cmdlet gets one or more service configuration objects stored in the Virtual Machine Manager (VMM) library.

Examples

Example 1: Get all service configuration objects in the library

PS C:\> $SvcConfigs = Get-SCServiceConfiguration -VMMServer "VMMServer01.Contoso.com" | where { $_.Name -match "Service" }
PS C:\> $SvcConfigs

The first command gets all service configuration objects on VMMServer01, selects from the results the service configuration objects that contain Service in their name, and then stores the objects in the $SvcConfigs variable.

The second command displays the properties of the service configuration objects to the user.

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:False
Accept pipeline input:True
Accept wildcard characters:False

-Name

Specifies the name of a VMM object.

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

-OnBehalfOfUser

Specifies a user name. This cmdlet operates on behalf of the user that this parameter specifies.

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

-OnBehalfOfUserRole

Specifies a user role. To obtain a user role, use the Get-SCUserRole cmdlet. This cmdlet operates on behalf of the user role that this parameter specifies.

Type:UserRole
Position:Named
Default value:None
Required:False
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

ServiceConfiguration

This cmdlet returns a ServiceConfiguration object.