次の方法で共有

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

説明

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 オブジェクトを指定できます。

型:Microsoft.EnterpriseManagement.Configuration.ManagementPackClass[]
配置:1
規定値:None
必須:True
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-ComputerName

接続を確立するコンピューターを指定します。 コンピューターが System Center Data Access サービスを実行している必要があります。 既定値は、現在の管理グループ接続のコンピューターです。

有効な形式には、NetBIOS 名、IP アドレス、または完全修飾ドメイン名 (FQDN) が含まれます。 ローカル コンピューターを指定するには、コンピューター名、"localhost"、またはドット (.) を入力します。

型:System.String[]
配置:Named
規定値:Localhost
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Credential

管理グループ接続を実行するユーザー アカウントを指定します。 アカウントは、ComputerName パラメーターで指定されているサーバーにアクセスできる必要があります (サーバーが指定されている場合)。 既定値は現在のユーザーです。

Get-Credential コマンドレットによって返される PSCredential オブジェクトを入力できます。

型:System.Management.Automation.PSCredential
配置:Named
規定値:Current user context
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Criteria

管理サーバーから返されるクラス インスタンスのセットを制限する抽出条件オブジェクトを指定します。

型:Microsoft.EnterpriseManagement.Common.EnterpriseManagementObjectCriteria
配置:1
規定値:None
必須:True
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-DisplayName

取得するクラス インスタンスの表示名を指定します。

型:System.String[]
配置:1
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Filter

結果セットをフィルター処理します。 フィルターの構文は、<プロパティ> 演算子 <値>です。有効な演算子は -eq、-ne、-gt、-ge、-lt、-le、-like、-notlike です。 フィルターを使用すると効率的です。これは、結果が PowerShell に返された後に適用されるのではなく、管理サーバーから取得される結果がフィルターによって制限されるためです。

型:System.String
配置:2
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Group

取得するクラス インスタンスを含むグループのインスタンスを指定します。

型:Microsoft.EnterpriseManagement.Common.EnterpriseManagementObject[]
配置:1
規定値:None
必須:True
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-Id

取得するクラス インスタンスの ID を指定します。 GUID または GUID に変換される文字列を指定できます。

型:System.Guid[]
配置:1
規定値:None
必須:True
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-Name

取得するクラス インスタンスの名前を指定します。

型:System.String[]
配置:1
規定値:None
必須:True
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-SCSession

管理サーバーへの接続を指定します。 既定値は、現在の管理グループ接続です。

Get-SCManagementGroupConnection コマンドレットによって返される管理グループ接続オブジェクトを入力できます。

型:Microsoft.SystemCenter.Core.Connection.Connection[]
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

入力

Microsoft.EnterpriseManagement.Configuration.ManagementPackClass

Get-SCSMClassInstance コマンドレットの Class パラメーターにクラスをパイプできます。

出力

EnterpriseManagementObject

このコマンドレットは、EnterpriseManagementObject#<classtype> オブジェクトを生成します。