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>] 説明
Get-SCSMClassInstance コマンドレットは、クラス インスタンスを取得します。
例
例 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 コマンドレットで使用されるパラメーターを定義します。
例 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
取得する 1 つまたは複数のクラスの名前を指定します。 Get-SCClass コマンドレットによって返される ManagementPackClass オブジェクトを指定できます。
| Type: | Microsoft.EnterpriseManagement.Configuration.ManagementPackClass[] |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-ComputerName
接続を確立するコンピューターを指定します。 コンピューターは、System Center データ アクセス サービスを実行している必要があります。 既定値は、現在の管理グループ接続のコンピューターです。
有効な形式は、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 コマンドレットによって返される 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 コマンドレットによって返される管理グループ接続オブジェクトを入力できます。
| 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 コマンドレットの Class パラメーターにクラスをパイプ処理できます。
出力
EnterpriseManagementObject
このコマンドレットは、 EnterpriseManagementObject#<classtype> オブジェクトを生成します。