Get-SCClassInstance
Ruft Klasseninstanzen ab.
Syntax
Empty (Standardwert)
Get-SCClassInstance
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[<CommonParameters>]
FromManagementPackClass
Get-SCClassInstance
[-Class] <ManagementPackClass[]>
[[-Filter] <String>]
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[<CommonParameters>]
FromEMODisplayNameParameterSetName
Get-SCClassInstance
[-DisplayName] <String[]>
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[<CommonParameters>]
FromEMONameParameterSetName
Get-SCClassInstance
[-Name] <String[]>
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[<CommonParameters>]
FromGroup
Get-SCClassInstance
[-Group] <EnterpriseManagementObject[]>
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[<CommonParameters>]
FromEMOIdParameterSetName
Get-SCClassInstance
[-Id] <Guid[]>
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[<CommonParameters>]
FromCriteria
Get-SCClassInstance
[-Criteria] <EnterpriseManagementObjectCriteria>
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[<CommonParameters>]
Beschreibung
Mit dem Cmdlet Get-SCClassInstance werden Klasseninstanzen abgerufen.
Beispiele
Beispiel 1: Abrufen von Computern nach NetBIOS-Namen
PS C:\>$MP = Get-SCManagementPack -name "Microsoft.Windows.Library"
PS C:\>$CriteriaFormat = '<Criteria
>> xmlns="http://Microsoft.EnterpriseManagement.Core.Criteria/"><Reference
>> Id="Microsoft.Windows.Library" Version="{0}" PublicKeyToken="{1}"
>> Alias="myMP"
>>/><Expression><SimpleExpression><ValueExpressionLeft><Property>$Target/Property[Type="myMP!Microsoft.Windows.Computer"]/NetbiosDomainName$</Property></ValueExpressionLeft><Operator>Equal</Operator><ValueExpressionRight><Value>IR2</Value></ValueExpressionRight></SimpleExpression></Expression></Criteria>'
PS C:\>$CriteriaType = "Microsoft.EnterpriseManagement.Common.EnterpriseManagementObjectCriteria"
PS C:\>$criteriaString = $criteriaFormat -f $MP.Version, $MP.KeyToken
PS C:\>$class = Get-SCClass -name "microsoft.windows.computer"
PS C:\>$criteria = new-object $CriteriaType $CriteriaString,$class,$class.ManagementGroup
PS C:\>Get-SCClassInstance -criteria $criteria
Mit diesen Befehlen werden Computer anhand des Kriteriums NetbiosDomainName gleich WOODGROVE abgerufen. Die ersten Befehle definieren die Parameter, die dann im abschließenden Cmdlet Get-SCClassInstance verwendet werden.
Beispiel 2: Abrufen von Klasseninstanzen mithilfe eines Filters
PS C:\>Get-SCClassInstance -class $class -filter 'NetbiosDomainName -eq "WOODGROVE"'
PrincipalName ObjectStatus ActiveDirectorySite NetBiosDomainName
------------- ------------ ------------------- -----------------
WIN-752HJBSX24M.woodgrove.com Active Default-First-Site-Name WOODGROVE
JWT-SCDW.woodgrove.com Active WOODGROVE
Mit diesem Befehl werden Klasseninstanzobjekte mithilfe eines Filters aus der Service Manager-Datenbank abgerufen. Beachten Sie, dass der Eigenschaftsname im Filter der genaue Name der Eigenschaft sein muss und dass zwischen Groß- und Kleinschreibung unterschieden wird.
Beispiel 3: Abrufen aller Computerobjekte
PS C:\>$class = Get-SCClass -name microsoft.windows.computer
PS C:\>Get-SCClassInstance -class $class|format-table PrincipalName,ObjectStatus,ActiveDirectorySite,NetbiosDomainName
PrincipalName ObjectStatus ActiveDirectorySite NetbiosDomainName
------------- ------------ ------------------- -----------------
WIN-752HJBSX24M.woodgrove.com Active Default-First-Site-Name WOODGROVE
JWT-SCDW.woodgrove.com Active WOODGROVE
Mit diesem Befehl werden alle Klasseninstanzobjekte vom Typ Computer aus der Service Manager-Datenbank abgerufen.
Parameter
-Class
Gibt den Namen einer oder mehrerer Klassen an, die abgerufen werden sollen. Sie können ein ManagementPackClass-Objekt angeben, das vom Cmdlet Get-SCClass zurückgegeben wird.
Parametereigenschaften
| Typ: | Microsoft.EnterpriseManagement.Configuration.ManagementPackClass[] |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
FromManagementPackClass
| Position: | 1 |
| Obligatorisch.: | True |
| Wert aus Pipeline: | True |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-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: | Localhost |
| 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: | Current user context |
| 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 |
-Criteria
Gibt ein Kriterienobjekt an, das die Gruppe der Klasseninstanzen einschränkt, die vom Verwaltungsserver zurückgegeben werden.
Parametereigenschaften
| Typ: | Microsoft.EnterpriseManagement.Common.EnterpriseManagementObjectCriteria |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
FromCriteria
| Position: | 1 |
| Obligatorisch.: | True |
| Wert aus Pipeline: | True |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-DisplayName
Gibt den Anzeigenamen der abzurufenden Klasseninstanz an.
Parametereigenschaften
| Typ: | System.String[] |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
FromEMODisplayNameParameterSetName
| Position: | 1 |
| Obligatorisch.: | True |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-Filter
Filtert die Ergebnismenge. Die Syntax des Filters ist der Wert< des >Eigenschaftsoperators<>, wobei die gültigen Operatoren -eq, -ne, -gt, -ge, -lt, -le, -like und -notlike sind. Die Verwendung eines Filters ist effizient, da der Filter die Ergebnisse einschränkt, die vom Verwaltungsserver abgerufen werden, anstatt angewendet zu werden, nachdem die Ergebnisse an PowerShell zurückgegeben wurden.
Parametereigenschaften
| Typ: | System.String |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
FromManagementPackClass
| Position: | 2 |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-Group
Gibt eine Instanz einer Gruppe an, die die abzurufenden Klasseninstanzen enthält.
Parametereigenschaften
| Typ: | Microsoft.EnterpriseManagement.Common.EnterpriseManagementObject[] |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
FromGroup
| 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 Klasseninstanzen 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
FromEMOIdParameterSetName
| Position: | 1 |
| Obligatorisch.: | True |
| Wert aus Pipeline: | True |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-Name
Gibt den Namen der abzurufenden Klasseninstanzen an.
Parametereigenschaften
| Typ: | System.String[] |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
FromEMONameParameterSetName
| 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
Microsoft.EnterpriseManagement.Configuration.ManagementPackClass
Sie können eine Klasse über die Pipeline an den Class-Parameter des Cmdlets Get-SCClassInstance übergeben.
Ausgaben
EnterpriseManagementObject
Mit diesem Cmdlet wird ein EnterpriseManagementObject#<classtype-Objekt> generiert.