Get-SCSMClassInstance

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 Cmdlet Get-SCSMClassInstance 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

Mit diesem Befehl werden Klasseninstanzobjekte aus der datenbank Service Manager mithilfe eines Filters abgerufen. Beachten Sie, dass der Eigenschaftsname 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

Mit diesen Befehlen werden alle Klasseninstanzobjekte vom Typ Computer aus der datenbank Service Manager abgerufen.

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:	Microsoft.EnterpriseManagement.Configuration.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:	System.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:	System.Management.Automation.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:	Microsoft.EnterpriseManagement.Common.EnterpriseManagementObjectCriteria
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-DisplayName

Gibt den Anzeigenamen der abzurufenden Klasseninstanz an.

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

-Filter

Filtert den Resultset. 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 angewendet zu werden, nachdem die Ergebnisse an PowerShell zurückgegeben wurden.

Type:	System.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 abzurufenden Klasseninstanzen enthält.

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

-Id

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

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

-Name

Gibt den Namen der abzurufenden Klasseninstanzen an.

Type:	System.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:	Microsoft.SystemCenter.Core.Connection.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> .

Ähnliche Themen

• New-SCSMClassInstance
• Remove-SCSMClassInstance
• Update-SCSMClassInstance