다음을 통해 공유

Get-SCSMClassInstance

  • 참조
모듈:
System.Center.Service.Manager

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

구문

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 개체를 지정할 수 있습니다.

형식:Microsoft.EnterpriseManagement.Configuration.ManagementPackClass[]
Position:1
Default value:None
필수:True
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-ComputerName

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

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

형식:System.String[]
Position:Named
Default value:Localhost
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-Credential

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

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

형식:System.Management.Automation.PSCredential
Position:Named
Default value:Current user context
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-Criteria

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

형식:Microsoft.EnterpriseManagement.Common.EnterpriseManagementObjectCriteria
Position:1
Default value:None
필수:True
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-DisplayName

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

형식:System.String[]
Position:1
Default value:None
필수:True
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-Filter

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

형식:System.String
Position:2
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-Group

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

형식:Microsoft.EnterpriseManagement.Common.EnterpriseManagementObject[]
Position:1
Default value:None
필수:True
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-Id

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

형식:System.Guid[]
Position:1
Default value:None
필수:True
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-Name

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

형식:System.String[]
Position:1
Default value:None
필수:True
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-SCSession

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

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

형식:Microsoft.SystemCenter.Core.Connection.Connection[]
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

입력

Microsoft.EnterpriseManagement.Configuration.ManagementPackClass

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

출력

EnterpriseManagementObject

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