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 データ アクセス サービスを実行している必要があります。 既定値は、現在の管理グループ接続のコンピューターです。

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

Type:System.String[]
Position:Named
Default value:None
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

-DisplayName

取得する関係オブジェクトの表示名を指定します。

Type:System.String[]
Position:1
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:True

-Id

取得する関係オブジェクトの ID を指定します。 これは、GUID または GUID に変換される文字列である場合があります。

Type:System.Guid[]
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ManagementPack

取得する関係を含む 1 つまたは複数の管理パックを指定します。

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

Type:Microsoft.EnterpriseManagement.Configuration.ManagementPack[]
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:True

-SCSession

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

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

Type:Microsoft.SystemCenter.Core.Connection.Connection[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Source

関係のソースを表すクラスを指定します。 複数のクラスを指定すると、それらのクラスのいずれかをソースとして持つすべての関係が返されます。 関係のソース クラスは、指定されたクラス型と完全に一致する必要があります。

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

Type:Microsoft.EnterpriseManagement.Configuration.ManagementPackClass[]
Position:1
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Target

関係のターゲットを表すクラスを指定します。 複数のクラスを指定すると、それらのクラスのいずれかをターゲットとして持つすべての関係が返されます。 関係のターゲット クラスは、指定されたクラス型と完全に一致する必要があります。

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

Type:Microsoft.EnterpriseManagement.Configuration.ManagementPackClass[]
Position:2
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters: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 パラメーターに名前をパイプできます。

出力

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