Export (0) Print
Expand All
This topic has not yet been rated - Rate this topic

Get-SCSMGroup

Updated: November 1, 2013

Applies To: System Center 2012 - Service Manager, System Center 2012 R2 Service Manager, System Center 2012 SP1 - Service Manager

Get-SCSMGroup

Retrieves groups from Service Manager.

Syntax

Parameter Set: Empty
Get-SCSMGroup [-ComputerName <String[]> ] [-Credential <PSCredential> ] [-SCSession <Connection[]> ] [ <CommonParameters>]

Parameter Set: FromGroupDisplayName
Get-SCSMGroup [-DisplayName] <String[]> [-ComputerName <String[]> ] [-Credential <PSCredential> ] [-SCSession <Connection[]> ] [ <CommonParameters>]

Parameter Set: FromGroupGuid
Get-SCSMGroup [-Id] <Guid[]> [-ComputerName <String[]> ] [-Credential <PSCredential> ] [-SCSession <Connection[]> ] [ <CommonParameters>]




Detailed Description

The Get-SCSMGroup cmdlet retrieves groups from Service Manager. The output of this cmdlet may be used by other cmdlets, such as the New-SCSMUserRole cmdlet.

Parameters

-ComputerName<String[]>

Specifies a computer to establish a connection with. The computer must be running the System Center Data Access service. The default value is the computer for the current management group connection.

Valid formats include a NetBIOS name, an IP address, or a fully qualified domain name (FQDN). To specify the local computer, type the computer name, "localhost", or a dot (.).


Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

true (ByValue)

Accept Wildcard Characters?

false

-Credential<PSCredential>

Specifies a user account under which the management group connection will run. The account must have access to the server that is specified in the ComputerName parameter, if the server is specified. The default value is the current user.

You can enter a PSCredential object that is returned by the Get-Credential cmdlet.


Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

true (ByValue)

Accept Wildcard Characters?

false

-DisplayName<String[]>

Specifies the display name of the groups to retrieve.


Aliases

none

Required?

true

Position?

1

Default Value

none

Accept Pipeline Input?

true (ByValue)

Accept Wildcard Characters?

true

-Id<Guid[]>

The Id of the groups to retrieve. This may be a Guid or a string that will be converted to a Guid.


Aliases

none

Required?

true

Position?

1

Default Value

none

Accept Pipeline Input?

true (ByValue)

Accept Wildcard Characters?

false

-SCSession<Connection[]>

Specifies a connection to a management server. The default value is the current management group connection.

You can enter a management group connection object that is returned by the Get-SCManagementGroupConnection cmdlet.


Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

true (ByValue)

Accept Wildcard Characters?

false

<CommonParameters>

This cmdlet supports the common parameters: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, and -OutVariable. For more information, see about_CommonParameters.

Inputs

The input type is the type of the objects that you can pipe to the cmdlet.

  • System.Guid

    You can pipe a group Guid to the Id parameter of the Get-SCSMGroup cmdlet.


  • System.String

    You can pipe a name of a group to the DisplayName parameter of the Get-SCSMGroup cmdlet.


Outputs

The output type is the type of the objects that the cmdlet emits.

  • Microsoft.EnterpriseManagement.Common.EnterpriseManagementObject

    The output of this cmdlets is a group object.


Examples

-------------------------- EXAMPLE 1 --------------------------

The command in this example retrieves groups from Service Manager.


PS C:\>Get-SCSMGroup
Id                                   FullName
-- --------
3c8ac4f3-475e-44dd-4163-8a97af363705 Microsoft.SystemCenter.AllComputersGroup
04bca169-5094-4b85-8704-067f333aa830 Microsoft.SystemCenter.CollectionManagementServerComputersGroup
95fe7deb-f466-ca83-aa8d-9845c386cd5a Microsoft.SystemCenter.GatewayManagementServerComputersGroup
099bfe0f-fddb-8d5a-67af-a79317eb6e91 Microsoft.SystemCenter.ManagementServerComputersGroup
0e7983be-95b9-aed8-ff93-8819e4cefcaa Microsoft.SystemCenter.RootManagementServerComputersGroup
3c1ef0a3-b773-11c8-b150-c4e47e5b7d91 Microsoft.SystemCenter.AgentlessManagedComputerGroup
e394c529-dfca-bdb4-5a86-d46078622200 Microsoft.SystemCenter.AgentManagedComputerGroup
e929bd61-1615-ba70-62b2-9fd5eee8aa09 Microsoft.SystemCenter.ManagedComputerClientHealthServiceWatcherGroup
93cb6af4-3e3d-53f6-06a7-04a469197a9c Microsoft.SystemCenter.OpsMgrDBWatchersGroup
a528b843-301e-4e61-6679-104243bbdb6b InstanceGroup_dbbcf4ea8ff241839b6154026698ceb2


-------------------------- EXAMPLE 2 --------------------------

The command in this example retrieves groups and then displays their FullName and DisplayName properties.


PS C:\>Get-SCSMGroup |ft fullname,displayname
FullName                                                                      DisplayName
-------- -----------
Microsoft.SystemCenter.AllComputersGroup All Windows Computers
Microsoft.SystemCenter.CollectionManagementServerComputersGroup Collection Management Server Computer Group
Microsoft.SystemCenter.GatewayManagementServerComputersGroup Gateway Management Server Computer Group
Microsoft.SystemCenter.ManagementServerComputersGroup Management Server Computer Group
Microsoft.SystemCenter.RootManagementServerComputersGroup Root Management Server Computer Group
Microsoft.SystemCenter.AgentlessManagedComputerGroup Agentless Managed Computer Group
Microsoft.SystemCenter.AgentManagedComputerGroup Agent Managed Computer Group
Microsoft.SystemCenter.ManagedComputerClientHealthServiceWatcherGroup Managed Computer Client Management Service Watcher Group
Microsoft.SystemCenter.OpsMgrDBWatchersGroup System Center Operations Manager Operational Database Watcher Group
InstanceGroup_dbbcf4ea8ff241839b6154026698ceb2 mygroup


-------------------------- EXAMPLE 3 --------------------------

The command in this example retrieves the All Windows Computers group.


PS C:\>Get-SCSMGroup -DisplayName "All Windows Computers"
Id                                   FullName
-- --------
3c8ac4f3-475e-44dd-4163-8a97af363705 Microsoft.SystemCenter.AllComputersGroup


-------------------------- EXAMPLE 4 --------------------------

The command in this example retrieves the All Windows Computers group and then displays all of its properties.


PS C:\>Get-SCSMGroup -DisplayName "All Windows Computers"|fl
Name                                         :
Path :
DisplayName : All Windows Computers
FullName : Microsoft.SystemCenter.AllComputersGroup
ManagementPackClassIds : {3c8ac4f3-475e-44dd-4163-8a97af363705}
LeastDerivedNonAbstractManagementPackClassId : 3c8ac4f3-475e-44dd-4163-8a97af363705
TimeAdded : 12/2/2010 12:19:56 AM
LastModifiedBy :
Values : {System.ConfigItem.ObjectStatusEnum.Active, (null), (null), All Windows Computers}
LastModified : 12/2/2010 12:19:56 AM
IsNew : False
HasChanges : False
Id : 3c8ac4f3-475e-44dd-4163-8a97af363705
ManagementGroup : psimp2
ManagementGroupId : 048d4708-ede4-5aed-1317-81d1b0d0b395

 
Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft. All rights reserved.