Get-SCSMClassInstance

참조

모듈:: System.Center.Service.Manager

클래스 인스턴스를 가져옵니다.

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

Description

Get-SCSMClassInstance cmdlet은 클래스 인스턴스를 검색합니다.

예제

예제 1: NetBIOS 이름으로 컴퓨터 가져오기

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

이러한 명령은 NetbiosDomainName 의 조건을 사용하여 WOODGROVE와 동일한 컴퓨터를 검색합니다. 첫 번째 명령은 최종 Get-SCSMClassInstance cmdlet에서 사용되는 매개 변수를 정의합니다.

예제 2: 필터를 사용하여 클래스 인스턴스 가져오기

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

이 명령은 필터를 사용하여 Service Manager 데이터베이스에서 클래스 인스턴스 개체를 검색합니다. 필터의 속성 이름은 속성의 정확한 이름이어야 하며, 대/소문자를 구분합니다.

예제 3: 모든 컴퓨터 개체 가져오기

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

이 명령은 Service Manager 데이터베이스에서 Computer 형식의 모든 클래스 인스턴스 개체를 검색합니다.

매개 변수

-Class

검색할 하나 이상의 클래스에 대한 이름을 지정합니다. Get-SCClass cmdlet에서 반환되는 ManagementPackClass 개체를 지정할 수 있습니다.

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

-ComputerName

연결을 설정할 컴퓨터를 지정합니다. 이 컴퓨터는 System Center Data Access 서비스를 실행해야 합니다. 기본값은 현재 관리 그룹 연결용 컴퓨터입니다.

유효한 형식에는 NetBIOS 이름, IP 주소 또는 FQDN(정규화된 도메인 이름)이 포함됩니다. 로컬 컴퓨터를 지정하려면 컴퓨터 이름, "localhost" 또는 점(.)을 입력하세요.

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

-Credential

관리 그룹 연결을 실행할 사용자 계정을 지정합니다. 서버가 지정된 경우 ComputerName 매개 변수에 지정된 서버에 대한 액세스 권한이 계정에 있어야 합니다. 기본값은 현재 사용자입니다.

Get-Credential cmdlet에서 반환되는 PSCredential 개체를 입력할 수 있습니다.

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

-Criteria

관리 서버에서 반환되는 클래스 인스턴스 집합을 제한하는 조건 개체를 지정합니다.

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

-DisplayName

검색할 클래스 인스턴스의 표시 이름을 지정합니다.

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

-Filter

결과 집합을 필터링합니다. 필터의 구문은 속성> 연산자 값>입니다<. 여기서 유효한 연산<자는 -eq, -ne, -gt, -ge, -lt, -le, -like 및 -notlike입니다. 필터를 사용하면 결과가 PowerShell로 반환된 후 적용되지 않고 관리 서버에서 검색되는 결과가 제한되기 때문에 효율적입니다.

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

-Group

검색할 클래스 인스턴스가 포함된 그룹의 인스턴스를 지정합니다.

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

-Id

검색할 클래스 인스턴스의 ID를 지정합니다. GUID 또는 GUID로 변환될 문자열일 수 있습니다.

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

-Name

검색할 클래스 인스턴스의 이름을 지정합니다.

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

-SCSession

관리 서버에 대한 연결을 지정합니다. 기본값은 현재 관리 그룹 연결입니다.

Get-SCManagementGroupConnection cmdlet에서 반환되는 관리 그룹 연결 개체를 입력할 수 있습니다.

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

입력

Microsoft.EnterpriseManagement.Configuration.ManagementPackClass

클래스를 Get-SCSMClassInstance cmdlet의 클래스 매개 변수로 파이프할 수 있습니다.

출력

EnterpriseManagementObject

이 cmdlet은 EnterpriseManagementObject#<classtype> 개체를 생성합니다.