Freigeben über

Get-SCOMGroup

  • Referenz
Modul:
OperationsManager

Ruft Operations Manager-Gruppen ab.

Syntax

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

Beschreibung

Das cmdlet Get-SCOMGroup ruft System Center - Operations Manager-Gruppen ab. Sie können angeben, welche Gruppen nach Name oder ID abgerufen werden sollen.

Da ein Gruppenobjekt ein Klasseninstanzobjekttyp ist, kann es an den parameter Instance eines anderen Cmdlets übergeben werden, z. B. das Cmdlet Enable-SCOMDiscovery.

Standardmäßig verwendet dieses Cmdlet die aktive dauerhafte Verbindung zu einer Verwaltungsgruppe. Verwenden Sie den SCSession--Parameter, um eine andere dauerhafte Verbindung anzugeben. Sie können eine temporäre Verbindung mit einer Verwaltungsgruppe erstellen, indem Sie die Parameter ComputerName und Anmeldeinformationen verwenden. Geben Sie Get-Help about_OpsMgr_Connectionsein, um weitere Informationen zu erfahren.

Beispiele

Beispiel 1: Abrufen von Gruppen mithilfe von Anzeigenamen

PS C:\>Get-SCOMGroup -DisplayName "*Agent*","*Windows*"

Dieser Befehl ruft alle Gruppen ab, die einen Anzeigenamen enthalten, der Agent und alle Gruppen enthält, die einen Anzeigenamen enthalten, der Windows enthält.

Beispiel 2: Abrufen einer Gruppe mithilfe einer ID

PS C:\>Get-SCOMGroup -Id 7413b06b-a95b-4ae3-98f2-dac9ff76dabd

Dieser Befehl ruft die Gruppe ab, die über eine ID von 7413b06b-a95b-4ae3-98f2-dac9ff76dabd verfügt.

Parameter

-ComputerName

Gibt ein Array von Namen von Computern an. Das Cmdlet richtet temporäre Verbindungen mit Verwaltungsgruppen für diese Computer ein. Sie können NetBIOS-Namen, IP-Adressen oder vollqualifizierte Domänennamen (FQDNs) verwenden. Um den lokalen Computer anzugeben, geben Sie den Computernamen, den Localhost oder einen Punkt (.) ein.

Der System Center Data Access-Dienst muss auf dem Computer ausgeführt werden. Wenn Sie keinen Computer angeben, verwendet das Cmdlet den Computer für die aktuelle Verwaltungsgruppenverbindung.

Typ:String[]
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Credential

Gibt ein PSCredential- -Objekt für die Verwaltungsgruppenverbindung an. Um ein PSCredential-Objekt abzurufen, verwenden Sie das Cmdlet Get-Credential. Geben Sie Get-Help Get-Credentialein, um weitere Informationen zu erfahren.

Wenn Sie einen Computer im parameter ComputerName angeben, verwenden Sie ein Konto, das Zugriff auf diesen Computer hat. Die Standardeinstellung ist der aktuelle Benutzer.

Typ:PSCredential
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DisplayName

Gibt ein Array von Anzeigenamen an. Die Werte für diesen Parameter hängen davon ab, welche lokalisierten Management Packs Sie importieren, und vom Gebietsschema des Benutzers, der Windows PowerShell ausführt.

Typ:String[]
Position:1
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:True

-Id

Gibt ein Array von GUIDs von Gruppen an. Ein SCOMGroup--Objekt enthält eine GUID als Id-Eigenschaft.

Typ:Guid[]
Position:1
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-SCSession

Gibt ein Array von Connection -Objekten an. Um ein Connection-Objekt abzurufen, verwenden Sie das Cmdlet Get-SCOMManagementGroupConnection.

Typ:Connection[]
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False