Delen via

Get-SCSMClassInstance

  • Referentie
Module:
System.Center.Service.Manager

Hiermee haalt u klasse-exemplaren op.

Syntaxis

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>]

Description

De Get-SCSMClassInstance cmdlet haalt klasse-exemplaren op.

Voorbeelden

Voorbeeld 1: Computers ophalen op NetBIOS-naam

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

Met deze opdrachten worden computers opgehaald met behulp van de criteria van NetbiosDomainName is gelijk aan WOODGROVE-. Met de eerste opdrachten worden de parameters gedefinieerd die vervolgens worden gebruikt in de laatste Get-SCSMClassInstance cmdlet.

Voorbeeld 2: Klasse-exemplaren ophalen met behulp van een filter

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

Met deze opdracht worden klasse-exemplaarobjecten opgehaald uit de Service Manager-database met behulp van een filter. Houd er rekening mee dat de eigenschapsnaam in het filter de exacte naam van de eigenschap moet zijn en dat deze hoofdlettergevoelig is.

Voorbeeld 3: Alle computerobjecten ophalen

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

Met deze opdrachten worden alle klasse-exemplaarobjecten van het type Computer opgehaald uit de Service Manager-database.

Parameters

-Class

Hiermee geeft u de naam van een of meer klassen op die moeten worden opgehaald. U kunt een ManagementPackClass--object opgeven dat wordt geretourneerd door de cmdlet Get-SCClass.

Type:Microsoft.EnterpriseManagement.Configuration.ManagementPackClass[]
Position:1
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-ComputerName

Hiermee geeft u een computer waarmee een verbinding tot stand moet worden gebracht. Op de computer moet de System Center Data Access-service worden uitgevoerd. De standaardwaarde is de computer voor de huidige verbinding met de beheergroep.

Geldige indelingen zijn een NetBIOS-naam, een IP-adres of een FQDN (Fully Qualified Domain Name). Als u de lokale computer wilt opgeven, typt u de computernaam, localhost of een punt (.).

Type:System.String[]
Position:Named
Default value:Localhost
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Credential

Hiermee geeft u een gebruikersaccount op waaronder de verbinding met de beheergroep wordt uitgevoerd. Het account moet toegang hebben tot de server die is opgegeven in de ComputerName parameter, als de server is opgegeven. De standaardwaarde is de huidige gebruiker.

U kunt een PSCredential-object invoeren dat wordt geretourneerd door de cmdlet Get-Credential.

Type:System.Management.Automation.PSCredential
Position:Named
Default value:Current user context
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Criteria

Hiermee geeft u een criteriumobject op waarmee de set klasse-exemplaren wordt beperkt die worden geretourneerd van de beheerserver.

Type:Microsoft.EnterpriseManagement.Common.EnterpriseManagementObjectCriteria
Position:1
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-DisplayName

Hiermee geeft u de weergavenaam van het klasse-exemplaar dat moet worden opgehaald.

Type:System.String[]
Position:1
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Filter

Hiermee filtert u de resultatenset. De syntaxis van het filter is de <eigenschap> operator <waarde>, waarbij geldige operatoren -eq, -ne, -gt, -ge, -lt, -le, -like en -notlike zijn. Het gebruik van een filter is efficiënt omdat het filter de resultaten beperkt die worden opgehaald van de beheerserver, in plaats van te worden toegepast nadat de resultaten zijn geretourneerd naar PowerShell.

Type:System.String
Position:2
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Group

Hiermee geeft u een exemplaar op van een groep die de klasse-exemplaren bevat die moeten worden opgehaald.

Type:Microsoft.EnterpriseManagement.Common.EnterpriseManagementObject[]
Position:1
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-Id

Hiermee geeft u de id op van de klasse-exemplaren die moeten worden opgehaald. Dit kan een GUID of een tekenreeks zijn die wordt geconverteerd naar een GUID.

Type:System.Guid[]
Position:1
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-Name

Hiermee geeft u de naam op van de klasse-exemplaren die moeten worden opgehaald.

Type:System.String[]
Position:1
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-SCSession

Hiermee geeft u een verbinding met een beheerserver. De standaardwaarde is de huidige verbinding met de beheergroep.

U kunt een verbindingsobject voor een beheergroep invoeren dat wordt geretourneerd door de Get-SCManagementGroupConnection cmdlet.

Type:Microsoft.SystemCenter.Core.Connection.Connection[]
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

Invoerwaarden

Microsoft.EnterpriseManagement.Configuration.ManagementPackClass

U kunt een klasse doorsluisen naar de parameter Klasse van de Get-SCSMClassInstance-cmdlet.

Uitvoerwaarden

EnterpriseManagementObject

Met deze cmdlet wordt een EnterpriseManagementObject#<classtype>-object gegenereerd.