Get-SCRelationship
Получает информацию об объектах отношений из Service Manager.
Синтаксис
Empty (по умолчанию)
Get-SCRelationship
[[-Source] <ManagementPackClass[]>]
[[-Target] <ManagementPackClass[]>]
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[<CommonParameters>]
FromRelationshipDisplayName
Get-SCRelationship
[-DisplayName] <String[]>
[[-Source] <ManagementPackClass[]>]
[[-Target] <ManagementPackClass[]>]
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[<CommonParameters>]
FromRelationshipId
Get-SCRelationship
[-Id] <Guid[]>
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[<CommonParameters>]
FromManagementPack
Get-SCRelationship
[-ManagementPack] <ManagementPack[]>
[[-Source] <ManagementPackClass[]>]
[[-Target] <ManagementPackClass[]>]
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[<CommonParameters>]
FromRelationshipName
Get-SCRelationship
[-Name] <String[]>
[[-Source] <ManagementPackClass[]>]
[[-Target] <ManagementPackClass[]>]
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[<CommonParameters>]
Описание
Командлет Get-SCRelationship извлекает сведения об объектах отношений из Service Manager.
Примеры
Пример 1: Получение информации об объектах отношений
PS C:\>Get-SCRelationship | 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
Эта команда извлекает информацию о трех объектах отношений.
Пример 2: Получение связей, которые нацелены на элементы конфигурации
PS C:\>$x = Get-SCClass -name "system.configitem"
PS C:\>Get-SCRelationship -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
Эти команды извлекают отношения, которые нацелены на элементы конфигурации.
Пример 3: Получение связей, которые нацелены на элементы конфигурации и их производные типы
PS C:\>$x = Get-SCClass -name "system.configitem"
PS C:\>$y = @($x; $x.GetDerivedTypes())
PS C:\>Get-SCRelationship â€"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 или точку (.).
Свойства параметра
| Тип: | System.String[] |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Credential
Указывает учетную запись пользователя, от имени которой будет выполняться подключение к группе управления. Учетная запись должна иметь доступ к серверу, указанному в параметре ComputerName , если сервер указан. Значение по умолчанию — текущий пользователь.
Вы можете ввести объект PSCredential , который возвращается командлетом Get-Credential .
Свойства параметра
| Тип: | System.Management.Automation.PSCredential |
| Default value: | Current user context |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-DisplayName
Указывает отображаемое имя извлекаемого объекта отношения.
Свойства параметра
| Тип: | System.String[] |
| Default value: | None |
| Поддерживаются подстановочные знаки: | True |
| DontShow: | False |
Наборы параметров
FromRelationshipDisplayName
| Position: | 1 |
| Обязательно: | True |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Id
Указывает идентификатор объекта отношения для извлечения. Это может быть GUID или строка, которая будет преобразована в GUID.
Свойства параметра
| Тип: | System.Guid[] |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
FromRelationshipId
| Position: | 1 |
| Обязательно: | True |
| Значение из конвейера: | True |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-ManagementPack
Указывает один или несколько пакетов управления, содержащих связи для извлечения.
Можно ввести объект ManagementPack , возвращаемый командлетом Get-SCManagementPack.
Свойства параметра
| Тип: | Microsoft.EnterpriseManagement.Configuration.ManagementPack[] |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
FromManagementPack
| Position: | 1 |
| Обязательно: | True |
| Значение из конвейера: | True |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Name
Указывает имя извлекаемого объекта отношения.
Свойства параметра
| Тип: | System.String[] |
| Default value: | None |
| Поддерживаются подстановочные знаки: | True |
| DontShow: | False |
Наборы параметров
FromRelationshipName
| Position: | 1 |
| Обязательно: | True |
| Значение из конвейера: | True |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-SCSession
Указывает подключение к серверу управления. Значением по умолчанию является текущее подключение к группе управления.
Можно ввести объект подключения к группе управления, который возвращается командлетом Get-SCManagementGroupConnection.
Свойства параметра
| Тип: | Microsoft.SystemCenter.Core.Connection.Connection[] |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Source
Указывает классы, представляющие источник связи. Если указано более одного класса, возвращается любая связь, которая имеет один из этих классов в качестве источника. Исходный класс отношения должен точно совпадать с указанным типом класса.
Если указать классы для параметров Target и Source , командлет возвращает все отношения, в которых целевой класс является одним из указанных целевых классов, а исходный класс — одним из указанных исходных классов.
Свойства параметра
| Тип: | Microsoft.EnterpriseManagement.Configuration.ManagementPackClass[] |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
Empty
| Position: | 1 |
| Обязательно: | False |
| Значение из конвейера: | True |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
FromRelationshipDisplayName
| Position: | 1 |
| Обязательно: | False |
| Значение из конвейера: | True |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
FromManagementPack
| Position: | 1 |
| Обязательно: | False |
| Значение из конвейера: | True |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
FromRelationshipName
| Position: | 1 |
| Обязательно: | False |
| Значение из конвейера: | True |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Target
Указывает классы, представляющие цель отношения. Если указано несколько классов, возвращается любая связь, которая имеет один из этих классов в качестве цели. Целевой класс отношения должен точно совпадать с указанным типом класса.
Если указать классы для параметров Target и Source , командлет возвращает все отношения, в которых целевой класс является одним из указанных целевых классов, а исходный класс — одним из указанных исходных классов.
Свойства параметра
| Тип: | Microsoft.EnterpriseManagement.Configuration.ManagementPackClass[] |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
Empty
| Position: | 2 |
| Обязательно: | False |
| Значение из конвейера: | True |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
FromRelationshipDisplayName
| Position: | 2 |
| Обязательно: | False |
| Значение из конвейера: | True |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
FromManagementPack
| Position: | 2 |
| Обязательно: | False |
| Значение из конвейера: | True |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
FromRelationshipName
| Position: | 2 |
| Обязательно: | False |
| Значение из конвейера: | True |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
CommonParameters
Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в разделе about_CommonParameters.
Входные данные
Microsoft.EnterpriseManagement.Configuration.ManagementPackClass
Исходный класс можно передать по конвейеру в параметр Source командлета Get-SCRelationship .
Microsoft.EnterpriseManagement.Configuration.ManagementPackClass
Целевой класс можно передать по конвейеру в параметр Target командлета Get-SCRelationship .
System.Guid
Вы можете передать идентификатор GUID в параметр Id командлета Get-SCRelationship .
Microsoft.EnterpriseManagement.Configuration.ManagementPack
Вы можете передать пакет управления в параметр ManagementPack командлета Get-SCRelationship .
System.String
Вы можете передать имя в параметр Name командлета Get-SCRelationship .
Выходные данные
None
Этот командлет не создает выходные данные.