Delen via


Get-SCSMGroup

Hiermee haalt u groepen op uit Service Manager.

Syntaxis

Get-SCSMGroup
   [-SCSession <Connection[]>]
   [-ComputerName <String[]>]
   [-Credential <PSCredential>]
   [<CommonParameters>]
Get-SCSMGroup
   [-DisplayName] <String[]>
   [-SCSession <Connection[]>]
   [-ComputerName <String[]>]
   [-Credential <PSCredential>]
   [<CommonParameters>]
Get-SCSMGroup
   [-Id] <Guid[]>
   [-SCSession <Connection[]>]
   [-ComputerName <String[]>]
   [-Credential <PSCredential>]
   [<CommonParameters>]

Description

De cmdlet Get-SCSMGroup haalt groepen op uit Service Manager. De uitvoer van deze cmdlet kan worden gebruikt door andere cmdlets, zoals de New-SCSMUserRole cmdlet.

Voorbeelden

Voorbeeld 1: Groepen ophalen uit 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

Met deze opdracht worden groepen opgehaald uit Service Manager.

Voorbeeld 2: Groepen ophalen en hun details weergeven in een tabel

PS C:\>Get-SCSMGroup |Format-Table 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

Met deze opdracht worden groepen opgehaald en worden de eigenschappen FullName en DisplayName weergegeven.

Voorbeeld 3: De details van een groep ophalen

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

Met deze opdracht wordt de groep Alle Windows-computers opgehaald.

Voorbeeld 4: Een groep ophalen en de eigenschappen ervan weergeven

PS C:\>Get-SCSMGroup -DisplayName "All Windows Computers"|Format-List
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

Met deze opdracht wordt de groep Alle Windows-computers opgehaald en worden alle eigenschappen ervan weergegeven.

Parameters

-ComputerName

Hiermee geeft u een computer waarmee een verbinding tot stand moet worden gebracht. Op de computer moet de System Center Data Access-service worden uitgevoerd. De standaardwaarde is de computer voor de huidige verbinding met de beheergroep.

Geldige indelingen zijn een NetBIOS-naam, een IP-adres of een FQDN (Fully Qualified Domain Name). Als u de lokale computer wilt opgeven, typt u de computernaam, localhost of een punt (.).

Type:System.String[]
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Credential

Hiermee geeft u een gebruikersaccount op waaronder de verbinding met de beheergroep wordt uitgevoerd. Het account moet toegang hebben tot de server die is opgegeven in de ComputerName parameter, als de server is opgegeven. De standaardwaarde is de huidige gebruiker.

U kunt een PSCredential-object invoeren dat wordt geretourneerd door de cmdlet Get-Credential.

Type:System.Management.Automation.PSCredential
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-DisplayName

Hiermee geeft u de weergavenaam van de groepen die moeten worden opgehaald.

Type:System.String[]
Position:1
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:True

-Id

Hiermee geeft u de id van de groepen op die moeten worden opgehaald. Dit kan een GUID of een tekenreeks zijn die wordt geconverteerd naar een GUID.

Type:System.Guid[]
Position:1
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-SCSession

Hiermee geeft u een verbinding met een beheerserver. De standaardwaarde is de huidige verbinding met de beheergroep.

U kunt een verbindingsobject voor een beheergroep invoeren dat wordt geretourneerd door de Get-SCManagementGroupConnection cmdlet.

Type:Microsoft.SystemCenter.Core.Connection.Connection[]
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

Invoerwaarden

System.Guid

U kunt een groeps-GUID doorsluisen naar de id parameter van de Get-SCSMGroup cmdlet.

System.String

U kunt een naam van een groep doorsluisen naar de parameter DisplayName van de cmdlet Get-SCSMGroup.

Uitvoerwaarden

Microsoft.EnterpriseManagement.Common.EnterpriseManagementObject

De uitvoer van deze cmdlets is een groepsobject.