Compartilhar via

Get-SCSMRelationship

  • Referência
Módulo:
System.Center.Service.Manager

Obtém informações sobre objetos de relação do Service Manager.

Sintaxe

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

Description

O cmdlet Get-SCSMRelationship recupera informações sobre objetos de relação do Service Manager.

Exemplos

Exemplo 1: Obter informações sobre objetos de relação

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

Esse comando recupera informações sobre três objetos de relação.

Exemplo 2: Obter relações que direcionam itens de configuração

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

Os comandos do Thse recuperam relações que direcionam itens de configuração.

Exemplo 3: Obter relações que direcionam itens de configuração e seus tipos derivados

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

Esses comandos recuperam relações que direcionam itens de configuração e todos os tipos derivados desses itens de configuração.

Parâmetros

-ComputerName

Especifica um computador com o qual estabelecer uma conexão. O computador deve estar executando o serviço de Acesso a Dados do System Center. O valor padrão é o computador para a conexão do grupo de gerenciamento atual.

Os formatos válidos incluem um nome NetBIOS, um endereço IP ou um FQDN (nome de domínio totalmente qualificado). Para especificar o computador local, digite o nome do computador, "localhost" ou um ponto (.).

Tipo:System.String[]
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Credential

Especifica uma conta de usuário na qual a conexão do grupo de gerenciamento será executada. A conta deve ter acesso ao servidor especificado no parâmetro ComputerName, se o servidor for especificado. O valor padrão é o usuário atual.

Você pode inserir um objeto PSCredential retornado pelo cmdlet Get-Credential.

Tipo:System.Management.Automation.PSCredential
Cargo:Named
Valor padrão:Current user context
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DisplayName

Especifica o nome de exibição do objeto de relação a ser recuperado.

Tipo:System.String[]
Cargo:1
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:True

-Id

Especifica a ID do objeto de relação a ser recuperado. Pode ser um GUID ou uma cadeia de caracteres que será convertida em um GUID.

Tipo:System.Guid[]
Cargo:1
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-ManagementPack

Especifica um ou mais pacotes de gerenciamento que contêm as relações a serem recuperadas.

Você pode inserir um objeto ManagementPack retornado pelo cmdlet Get-SCManagementPack.

Tipo:Microsoft.EnterpriseManagement.Configuration.ManagementPack[]
Cargo:1
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-Name

Especifica o nome do objeto de relação a ser recuperado.

Tipo:System.String[]
Cargo:1
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:True

-SCSession

Especifica uma conexão com um servidor de gerenciamento. O valor padrão é a conexão do grupo de gerenciamento atual.

Você pode inserir um objeto de conexão de grupo de gerenciamento retornado pelo cmdlet Get-SCManagementGroupConnection.

Tipo:Microsoft.SystemCenter.Core.Connection.Connection[]
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Source

Especifica as classes que representam a origem da relação. Se mais de uma classe for especificada, qualquer relação que tenha uma dessas classes como fonte será retornada. A classe de origem da relação deve ser uma correspondência exata do tipo de classe especificado.

Se você especificar classes para os parâmetros Target e source, o cmdlet retornará todas as relações nas quais a classe de destino é uma das classes de destino especificadas e a classe de origem é uma das classes de origem especificadas.

Tipo:Microsoft.EnterpriseManagement.Configuration.ManagementPackClass[]
Cargo:1
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-Target

Especifica as classes que representam o destino da relação. Se mais de uma classe for especificada, qualquer relação que tenha uma dessas classes como destino será retornada. A classe de destino da relação deve ser uma correspondência exata do tipo de classe especificado.

Se você especificar classes para os parâmetros Target e source, o cmdlet retornará todas as relações nas quais a classe de destino é uma das classes de destino especificadas e a classe de origem é uma das classes de origem especificadas.

Tipo:Microsoft.EnterpriseManagement.Configuration.ManagementPackClass[]
Cargo:2
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

Entradas

Microsoft.EnterpriseManagement.Configuration.ManagementPackClass

Você pode canalizar uma classe de origem para o parâmetro de origem do cmdlet Get-SCSMRelationship .

Microsoft.EnterpriseManagement.Configuration.ManagementPackClass

Você pode redirecionar uma classe de destino para o parâmetro Target do cmdlet Get-SCSMRelationship .

System.Guid

Você pode redirecionar um GUID para o parâmetro de ID de do cmdlet Get-SCSMRelationship.

Microsoft.EnterpriseManagement.Configuration.ManagementPack

Você pode canalizar um pacote de gerenciamento para o parâmetro ManagementPack do cmdlet Get-SCSMRelationship.

System.String

Você pode canalizar um nome para o parâmetro Name do cmdlet Get-SCSMRelationship.

Saídas

Esse cmdlet não gera nenhuma saída.