Get-SCSMRelationship

Service Manager からリレーションシップ オブジェクトに関する情報を取得します。

構文

Get-SCSMRelationship
   [[-Source] <ManagementPackClass[]>]
   [[-Target] <ManagementPackClass[]>]
   [-SCSession <Connection[]>]
   [-ComputerName <String[]>]
   [-Credential <PSCredential>]
   [<CommonParameters>]
Get-SCSMRelationship
   [-DisplayName] <String[]>
   [[-Source] <ManagementPackClass[]>]
   [[-Target] <ManagementPackClass[]>]
   [-SCSession <Connection[]>]
   [-ComputerName <String[]>]
   [-Credential <PSCredential>]
   [<CommonParameters>]
Get-SCSMRelationship
   [-Id] <Guid[]>
   [-SCSession <Connection[]>]
   [-ComputerName <String[]>]
   [-Credential <PSCredential>]
   [<CommonParameters>]
Get-SCSMRelationship
   [-ManagementPack] <ManagementPack[]>
   [[-Source] <ManagementPackClass[]>]
   [[-Target] <ManagementPackClass[]>]
   [-SCSession <Connection[]>]
   [-ComputerName <String[]>]
   [-Credential <PSCredential>]
   [<CommonParameters>]
Get-SCSMRelationship
   [-Name] <String[]>
   [[-Source] <ManagementPackClass[]>]
   [[-Target] <ManagementPackClass[]>]
   [-SCSession <Connection[]>]
   [-ComputerName <String[]>]
   [-Credential <PSCredential>]
   [<CommonParameters>]

説明

Get-SCSMRelationship コマンドレットは、Service Manager からリレーションシップ オブジェクトに関する情報を取得します。

例 1: リレーションシップ オブジェクトに関する情報を取得する

PS C:\>Get-SCSMRelationship | Select-Object -first 3
DisplayName : Primary User
Source      : System.Computer
Target      : System.User

DisplayName : Contains Configuration Item
Source      : System.ConfigItem
Target      : System.ConfigItem

DisplayName : Affects Customers
Source      : System.ConfigItem
Target      : System.User

このコマンドは、3 つのリレーションシップ オブジェクトに関する情報を取得します。

例 2: 構成項目を対象とするリレーションシップを取得する

PS C:\>$x = Get-SCSMClass -name "system.configitem"
PS C:\>Get-SCSMRelationship -Target $x
DisplayName : Contains Configuration Item

Source      : System.ConfigItem

Target      : System.ConfigItem

DisplayName : Is Related to Configuration Item

Source      : System.ConfigItem

Target      : System.ConfigItem


DisplayName : About Configuration Item

Source      : System.WorkItem

Target      : System.ConfigItem


DisplayName : Is Related to Configuration Item

Source      : System.WorkItem

Target      : System.ConfigItem


DisplayName : Collection has configuration item

Source      : Microsoft.SystemCenter.ConfigurationManager.CollectionInfo

Target      : System.ConfigItem

Thse コマンドは、構成項目を対象とするリレーションシップを取得します。

例 3: 構成項目とその派生型を対象とするリレーションシップを取得する

PS C:\>$x = Get-SCClass -name "system.configitem"
PS C:\>$y = @($x; $x.GetDerivedTypes())
PS C:\>Get-SCSMRelationship â€"Target $y
DisplayName : Contains Configuration Item

Source      : System.ConfigItem

Target      : System.ConfigItem


DisplayName : Is Related to Configuration Item

Source      : System.ConfigItem

Target      : System.ConfigItem


DisplayName : About Configuration Item

Source      : System.WorkItem

Target      : System.ConfigItem


DisplayName : Is Related to Configuration Item

Source      : System.WorkItem

Target      : System.ConfigItem


DisplayName : Collection has configuration item

Source      : Microsoft.SystemCenter.ConfigurationManager.CollectionInfo

Target      : System.ConfigItem


DisplayName : Is Related to Software Item

Source      : Microsoft.SystemCenter.ConfigurationManager.DCM_CI

Target      : Microsoft.SystemCenter.ConfigurationManager.DCM_CI


DisplayName : Contains program

Source      : Microsoft.SystemCenter.ConfigurationManager.Package

Target      : Microsoft.SystemCenter.ConfigurationManager.ProgramV5


DisplayName : Hosts program

Source      : Microsoft.SystemCenter.ConfigurationManager.Package

Target      : Microsoft.SystemCenter.ConfigurationManager.Program


DisplayName : Contains Physical Hardware

Source      : Microsoft.SystemCenter.ServiceDesigner.Messaging.Storage

Target      : System.PhysicalEntity


DisplayName : Links To Knowledge Document

Source      : System.Entity

Target      : System.Knowledge.Article


DisplayName :

Source      : Microsoft.EnterpriseManagement.LinkingFramework.OpsMgrConnector

Target      : Microsoft.EnterpriseManagement.LinkingFramework.OpsMgrConnector.Config


DisplayName : Is Related to Baseline Configuration Item

Source      : Microsoft.SystemCenter.WorkItem.DCMIncident

Target      : Microsoft.SystemCenter.ConfigurationManager.DCM_CI


DisplayName : Is Related to Configuration Item

Source      : Microsoft.SystemCenter.WorkItem.DCMIncident

Target      : Microsoft.SystemCenter.ConfigurationManager.DCM_CI


DisplayName : Assigned Program

Source      : Microsoft.SystemCenter.ConfigurationManager.Package

Target      : Microsoft.SystemCenter.ConfigurationManager.Program

これらのコマンドは、構成項目と、これらの構成項目から派生した任意の型を対象とするリレーションシップを取得します。

パラメーター

-ComputerName

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

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

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

-Credential

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

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

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

-DisplayName

取得するリレーションシップ オブジェクトの表示名を指定します。

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

-Id

取得するリレーションシップ オブジェクトの ID を指定します。 GUID または GUID に変換される文字列を指定できます。

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

-ManagementPack

取得するリレーションシップを含む 1 つ以上の管理パックを指定します。

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

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

-Name

取得するリレーションシップ オブジェクトの名前を指定します。

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

-SCSession

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

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

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

-Source

リレーションシップのソースを表すクラスを指定します。 複数のクラスが指定されている場合は、それらのクラスの 1 つをソースとして持つリレーションシップが返されます。 リレーションシップのソース クラスは、指定したクラス型と完全に一致している必要があります。

ターゲットSource パラメーターの両方にクラスを指定すると、コマンドレットは、ターゲット クラスが指定されたターゲット クラスの 1 つであり、ソース クラスが指定されたソース クラスの 1 つであるすべてのリレーションシップを返します。

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

-Target

リレーションシップのターゲットを表すクラスを指定します。 複数のクラスが指定されている場合は、それらのクラスの 1 つをターゲットとして持つリレーションシップが返されます。 リレーションシップのターゲット クラスは、指定したクラス型と完全に一致している必要があります。

ターゲットSource パラメーターの両方にクラスを指定すると、コマンドレットは、ターゲット クラスが指定されたターゲット クラスの 1 つであり、ソース クラスが指定されたソース クラスの 1 つであるすべてのリレーションシップを返します。

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

入力

Microsoft.EnterpriseManagement.Configuration.ManagementPackClass

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

Microsoft.EnterpriseManagement.Configuration.ManagementPackClass

ターゲット クラスは、Get-SCSMRelationship コマンドレットの Target パラメーターにパイプできます。

System.Guid

Get-SCSMRelationship コマンドレットの Id パラメーターに GUID をパイプできます。

Microsoft.EnterpriseManagement.Configuration.ManagementPack

管理パックは、Get-SCSMRelationship コマンドレットの ManagementPack パラメーターにパイプできます。

System.String

Get-SCSMRelationship コマンドレットの Name パラメーターに名前をパイプできます。

出力

このコマンドレットは出力を生成しません。