Freigeben über


Get-SCGroup

Ruft Gruppen von Service Manager ab.

Syntax

Empty (Standardwert)

Get-SCGroup
    [-SCSession <Connection[]>]
    [-ComputerName <String[]>]
    [-Credential <PSCredential>]
    [<CommonParameters>]

FromGroupDisplayName

Get-SCGroup
    [-DisplayName] <String[]>
    [-SCSession <Connection[]>]
    [-ComputerName <String[]>]
    [-Credential <PSCredential>]
    [<CommonParameters>]

FromGroupGuid

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

Beschreibung

Das Cmdlet Get-SCGroup ruft Gruppen aus Service Manager ab. Die Ausgabe dieses Cmdlets kann von anderen Cmdlets verwendet werden, z. B. von dem Cmdlet New-SCUserRole .

Beispiele

Beispiel 1: Abrufen von Gruppen aus Service Manager

PS C:\>Get-SCGroup
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

Mit diesem Befehl werden Gruppen aus Service Manager abgerufen.

Beispiel 2: Abrufen von Gruppen und Anzeigen ihrer Details in einer Tabelle

PS C:\>Get-SCGroup |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

Mit diesem Befehl werden Gruppen abgerufen und dann deren FullName - und DisplayName-Eigenschaften angezeigt.

Beispiel 3: Abrufen der Details einer Gruppe

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

Mit diesem Befehl wird die Gruppe "Alle Windows-Computer" abgerufen.

Beispiel 4: Abrufen einer Gruppe und Anzeigen ihrer Eigenschaften

PS C:\>Get-SCGroup -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

Mit diesem Befehl wird die Gruppe "Alle Windows-Computer" abgerufen und dann alle zugehörigen Eigenschaften angezeigt.

Parameter

-ComputerName

Gibt einen Computer an, mit dem eine Verbindung hergestellt werden soll. Auf dem Computer muss der System Center Data Access-Dienst ausgeführt werden. Der Standardwert ist der Computer für die aktuelle Verwaltungsgruppenverbindung.

Gültige Formate sind ein NetBIOS-Name, eine IP-Adresse oder ein vollqualifizierter Domänenname (Fully Qualified Domain Name, FQDN). Um den lokalen Computer anzugeben, geben Sie den Computernamen "localhost" oder einen Punkt (.) ein.

Parametereigenschaften

Typ:

System.String[]

Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Credential

Gibt ein Benutzerkonto an, unter dem die Verbindung mit der Verwaltungsgruppe ausgeführt wird. Das Konto muss Zugriff auf den Server haben, der im Parameter ComputerName angegeben ist, wenn der Server angegeben ist. Der Standardwert ist der aktuelle Benutzer.

Sie können ein PSCredential-Objekt eingeben, das vom Cmdlet Get-Credential zurückgegeben wird.

Parametereigenschaften

Typ:System.Management.Automation.PSCredential
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-DisplayName

Gibt den Anzeigenamen der abzurufenden Gruppen an.

Parametereigenschaften

Typ:

System.String[]

Standardwert:None
Unterstützt Platzhalter:True
Nicht anzeigen:False

Parametersätze

FromGroupDisplayName
Position:1
Obligatorisch.:True
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Id

Gibt die ID der abzurufenden Gruppen an. Dabei kann es sich um eine GUID oder eine Zeichenfolge handeln, die in eine GUID konvertiert wird.

Parametereigenschaften

Typ:

System.Guid[]

Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

FromGroupGuid
Position:1
Obligatorisch.:True
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-SCSession

Gibt eine Verbindung zu einem Management-Server an. Der Standardwert ist die aktuelle Verwaltungsgruppenverbindung.

Sie können ein Verbindungsobjekt für die Verwaltungsgruppe eingeben, das vom Cmdlet Get-SCManagementGroupConnection zurückgegeben wird.

Parametereigenschaften

Typ:

Microsoft.SystemCenter.Core.Connection.Connection[]

Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

CommonParameters

Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.

Eingaben

System.Guid

Sie können eine Gruppen-GUID über die Pipeline an den Id-Parameter des Cmdlets Get-SCGroup übergeben.

System.String

Sie können den Namen einer Gruppe über die Pipeline an den DisplayName-Parameter des Cmdlets Get-SCGroup übergeben.

Ausgaben

Microsoft.EnterpriseManagement.Common.EnterpriseManagementObject

Die Ausgabe dieses Cmdlets ist ein Gruppenobjekt.