Get-SCSMClassInstance

Referenz

Modul:: System.Center.Service.Manager

Ruft Klasseninstanzen ab.

Syntax

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

Get-SCSMClassInstance
   [-Class] <ManagementPackClass[]>
   [[-Filter] <String>]
   [-SCSession <Connection[]>]
   [-ComputerName <String[]>]
   [-Credential <PSCredential>]
   [<CommonParameters>]

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

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

Get-SCSMClassInstance
   [-Group] <EnterpriseManagementObject[]>
   [-SCSession <Connection[]>]
   [-ComputerName <String[]>]
   [-Credential <PSCredential>]
   [<CommonParameters>]

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

Get-SCSMClassInstance
   [-Criteria] <EnterpriseManagementObjectCriteria>
   [-SCSession <Connection[]>]
   [-ComputerName <String[]>]
   [-Credential <PSCredential>]
   [<CommonParameters>]

Beschreibung

Das Cmdlet "Get-SCSMClassInstance " ruft Klasseninstanzen ab.

Beispiele

Beispiel 1: Abrufen von Computern nach NetBIOS-Name

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-SCSMClassInstance -criteria $criteria

Diese Befehle rufen Computer mithilfe der Kriterien von NetbiosDomainName gleich WOODGROVE ab. Die ersten Befehle definieren die Parameter, die dann im endgültigen Get-SCSMClassInstance-Cmdlet verwendet werden.

Beispiel 2: Abrufen von Klasseninstanzen mithilfe eines Filters

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

Dieser Befehl ruft Klasseninstanzobjekte aus der Service Manager-Datenbank mithilfe eines Filters ab. Beachten Sie, dass der Eigenschaftenname im Filter der genaue Name der Eigenschaft sein muss und dass die Groß-/Kleinschreibung beachtet wird.

Beispiel 3: Abrufen aller Computerobjekte

PS C:\>$class = Get-SCSMClass -name microsoft.windows.computer
PS C:\>Get-SCSMClassInstance -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

Diese Befehle rufen alle Klasseninstanzobjekte vom Typ Computer aus der Service Manager-Datenbank ab.

Parameter

-Class

Gibt den Namen einer oder mehrerer Klassen an, die abgerufen werden sollen. Sie können ein ManagementPackClass-Objekt angeben, das vom Get-SCClass-Cmdlet zurückgegeben wird.

Type:	ManagementPackClass[]
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-ComputerName

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

Gültige Formate umfassen einen NetBIOS-Namen, eine IP-Adresse oder einen vollqualifizierten Domänennamen (FQDN). Um den lokalen Computer anzugeben, geben Sie den Computernamen, „localhost“ oder einen Punkt (.) ein.

Type:	String[]
Position:	Named
Default value:	Localhost
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Credential

Gibt ein Benutzerkonto an, unter dem die Verwaltungsgruppenverbindung ausgeführt wird. Das Konto muss Zugriff auf den Server haben, der im ComputerName-Parameter 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.

Type:	PSCredential
Position:	Named
Default value:	Current user context
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Criteria

Gibt ein Kriterienobjekt an, das den Satz von Klasseninstanzen beschränkt, die vom Verwaltungsserver zurückgegeben werden.

Type:	EnterpriseManagementObjectCriteria
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-DisplayName

Gibt den Anzeigenamen der Klasseninstanz an, die abgerufen werden soll.

Type:	String[]
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-Filter

Filtert den Ergebnissatz. Die Syntax des Filters ist der <Eigenschaftsoperatorwert><>, wobei gültige Operatoren -eq, -ne, -gt, -ge, -lt, -le, -like und -notlike sind. Die Verwendung eines Filters ist effizient, da der Filter die Ergebnisse beschränkt, die vom Verwaltungsserver abgerufen werden, anstatt nach der Rückgabe der Ergebnisse an PowerShell angewendet zu werden.

Type:	String
Position:	2
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Group

Gibt eine Instanz einer Gruppe an, die die Klasseninstanzen enthält, die abgerufen werden sollen.

Type:	EnterpriseManagementObject[]
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-Id

Gibt die ID der Klasseninstanzen an, die abgerufen werden sollen. Dies kann eine GUID oder eine Zeichenfolge sein, die in eine GUID konvertiert wird.

Type:	Guid[]
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-Name

Gibt den Namen der Klasseninstanzen an, die abgerufen werden sollen.

Type:	String[]
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-SCSession

Gibt eine Verbindung mit einem Verwaltungsserver an. Der Standardwert ist die aktuelle Verwaltungsgruppenverbindung.

Sie können ein Verwaltungsgruppenverbindungsobjekt eingeben, das vom Cmdlet Get-SCManagementGroupConnection zurückgegeben wird.

Type:	Connection[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

Eingaben

Microsoft.EnterpriseManagement.Configuration.ManagementPackClass

Sie können eine Klasse an den Klassenparameter des Cmdlets Get-SCSMClassInstance weiterleiten.

Ausgaben

EnterpriseManagementObject

Dieses Cmdlet generiert ein EnterpriseManagementObject#<classtype-Objekt> .