Get-SCSMRelationship

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

Obtém informações sobre objetos de relacionamento 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 relacionamento do Service Manager.

Exemplos

Exemplo 1: Obter informações sobre objetos de relacionamento

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

Este comando recupera informações sobre três objetos de relacionamento.

Exemplo 2: Obter relações que visam 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

Esses comandos recuperam relações que visam itens de configuração.

Exemplo 3: Obter relações que visam 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 visam itens de configuração e quaisquer 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 atual do grupo de gerenciamento.

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

Tipo:System.String[]
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Credential

Especifica uma conta de usuário sob a 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
Position:Named
Default value:Current user context
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-DisplayName

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

Tipo:System.String[]
Position:1
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:True

-Id

Especifica a ID do objeto de relacionamento a ser recuperado. Isso pode ser um GUID ou uma cadeia de caracteres que será convertida em um GUID.

Tipo:System.Guid[]
Position:1
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-ManagementPack

Especifica um ou mais pacotes de gerenciamento contendo as relações a serem recuperadas.

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

Tipo:Microsoft.EnterpriseManagement.Configuration.ManagementPack[]
Position:1
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-Name

Especifica o nome do objeto de relacionamento a ser recuperado.

Tipo:System.String[]
Position:1
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:True

-SCSession

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

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

Tipo:Microsoft.SystemCenter.Core.Connection.Connection[]
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais: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[]
Position:1
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais: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[]
Position:2
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

Entradas

Microsoft.EnterpriseManagement.Configuration.ManagementPackClass

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

Microsoft.EnterpriseManagement.Configuration.ManagementPackClass

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

System.Guid

Você pode canalizar um GUID para o parâmetro Id 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

Este cmdlet não gera nenhuma saída.