Partager via


Get-SCSMGroup

Obtient des groupes à partir de Service Manager.

Syntaxe

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

L’applet de commande Get-SCSMGroup récupère des groupes à partir de Service Manager. La sortie de cette applet de commande peut être utilisée par d’autres applets de commande, telles que l’applet de commande New-SCSMUserRole.

Exemples

Exemple 1 : Obtenir des groupes à partir de 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

Cette commande récupère des groupes à partir de Service Manager.

Exemple 2 : Obtenir des groupes et afficher leurs détails dans un tableau

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

Cette commande récupère les groupes, puis affiche leurs propriétés FullName et DisplayName.

Exemple 3 : Obtenir les détails d’un groupe

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

Cette commande récupère le groupe Tous les ordinateurs Windows.

Exemple 4 : Obtenir un groupe et afficher ses propriétés

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

Cette commande récupère le groupe Tous les ordinateurs Windows, puis affiche toutes ses propriétés.

Paramètres

-ComputerName

Spécifie un ordinateur avec lequel établir une connexion. L’ordinateur doit exécuter le service System Center Data Access. La valeur par défaut est l’ordinateur de la connexion de groupe d’administration actuelle.

Les formats valides incluent un nom NetBIOS, une adresse IP ou un nom de domaine complet (FQDN). Pour spécifier l’ordinateur local, tapez le nom de l’ordinateur, « localhost » ou un point (.).

Type:System.String[]
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Credential

Spécifie un compte d’utilisateur sous lequel la connexion au groupe d’administration s’exécutera. Le compte doit avoir accès au serveur spécifié dans le paramètre ComputerName, si le serveur est spécifié. La valeur par défaut est l’utilisateur actuel.

Vous pouvez entrer un objet PSCredential retourné par l’applet de commande Get-Credential .

Type:System.Management.Automation.PSCredential
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-DisplayName

Spécifie le nom complet des groupes à récupérer.

Type:System.String[]
Position:1
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:True

-Id

Spécifie l’ID des groupes à récupérer. Il peut s’agir d’un GUID ou d’une chaîne qui sera convertie en GUID.

Type:System.Guid[]
Position:1
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-SCSession

Spécifie une connexion à un serveur d’administration. La valeur par défaut est la connexion de groupe d’administration actuelle.

Vous pouvez entrer un objet de connexion de groupe d’administration retourné par l’applet de commande Get-SCManagementGroupConnection .

Type:Microsoft.SystemCenter.Core.Connection.Connection[]
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

Entrées

System.Guid

Vous pouvez diriger un GUID de groupe vers le paramètre ID de l’applet de commande Get-SCSMGroup Get-SCSMGroup.

System.String

Vous pouvez diriger un nom d’un groupe vers le paramètre DisplayName de l’applet de commande Get-SCSMGroup Get-SCSMGroup.

Sorties

Microsoft.EnterpriseManagement.Common.EnterpriseManagementObject

La sortie de ces applets de commande est un objet de groupe.