Get-SCSMClassInstance
取得類別實例。
語法
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 |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-ComputerName
指定要建立連線的電腦。 計算機必須執行 System Center 資料存取服務。 預設值是目前管理群組連線的計算機。
有效格式包括 NetBIOS 名稱、IP 位址或完整功能變數名稱 （FQDN）。 若要指定本機計算機，請輸入計算機名稱 「localhost」或點 （.）。
| 類型: | System.String[] |
| Position: | Named |
| 預設值: | Localhost |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-Credential
指定將執行管理群組連線的用戶帳戶。 如果指定伺服器，帳戶必須能夠存取 ComputerName 參數中指定的伺服器。 預設值為目前的使用者。
您可以輸入由 Get-Credential Cmdlet 所傳回 PSCredential 物件。
| 類型: | System.Management.Automation.PSCredential |
| Position: | Named |
| 預設值: | Current user context |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-Criteria
指定 criteria 物件，限制從管理伺服器傳回的類別實例集。
| 類型: | Microsoft.EnterpriseManagement.Common.EnterpriseManagementObjectCriteria |
| Position: | 1 |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-DisplayName
指定要擷取之類別實例的顯示名稱。
| 類型: | System.String[] |
| Position: | 1 |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-Filter
篩選結果集。 篩選的語法是 <屬性> 運算子 <值>，其中有效的運算符為 -eq、-ne、-gt、-ge、-lt、-le、-like 和 -notlike。 使用篩選很有效率，因為篩選會限制從管理伺服器擷取的結果，而不是在結果傳回 PowerShell 之後套用。
| 類型: | System.String |
| Position: | 2 |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-Group
指定要擷取之類別實例的群組實例。
| 類型: | Microsoft.EnterpriseManagement.Common.EnterpriseManagementObject[] |
| Position: | 1 |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-Id
指定要擷取之類別實例的標識碼。 這可能是 GUID 或將轉換成 GUID 的字串。
| 類型: | System.Guid[] |
| Position: | 1 |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-Name
指定要擷取的類別實例名稱。
| 類型: | System.String[] |
| Position: | 1 |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-SCSession
指定與管理伺服器的連線。 預設值為目前的管理群組連線。
您可以輸入由 Get-SCManagementGroupConnection Cmdlet 所傳回的管理群組連接物件。
| 類型: | Microsoft.SystemCenter.Core.Connection.Connection[] |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
輸入
Microsoft.EnterpriseManagement.Configuration.ManagementPackClass
您可以使用管線將類別傳送至 Get-SCSMClassInstance Cmdlet 的 Class 參數。
輸出
EnterpriseManagementObject
此 Cmdlet 會產生 EnterpriseManagementObject#<classtype> 物件。