Remove-ConnectorFromTier

Remove-ConnectorFromTier

Removes an Operations Manager Connector Framework connector from a specified tier.

Syntax

Parameter Set: Empty
Remove-ConnectorFromTier [-Connector] <MonitoringConnector> [-Tier] <TieredManagementGroup> [-Confirm] [-WhatIf] [ <CommonParameters>]

Detailed Description

Removes an Operations Manager Connector Framework connector from a specified tier.

Parameters

-Connector<MonitoringConnector>

Specifies the connector to remove. You can use Get-Connector to retrieve an object to use as the value of this parameter.

Aliases

none

Required?

true

Position?

2

Default Value

none

Accept Pipeline Input?

true (ByValue)

Accept Wildcard Characters?

false

-Tier<TieredManagementGroup>

Specifies the tier from which to remove the connector. You can use Get-Tier to retrieve an object to use as the value of this parameter.

Aliases

none

Required?

true

Position?

3

Default Value

none

Accept Pipeline Input?

true (ByValue)

Accept Wildcard Characters?

false

-Confirm

Prompts you for confirmation before executing the command.

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-WhatIf

Describes what would happen if you executed the command without actually executing the command.

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

<CommonParameters>

This cmdlet supports the common parameters: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, and -OutVariable. For more information, see about_CommonParameters

Notes

  • For more information, type "Get-Help Remove-ConnectorFromTier -detailed". For technical information, type "Get-Help Remove-ConnectorFromTier -full".
    When specifying multiple values for a parameter, use commas to separate the values. For example, "<parameter-name> <value1>, <value2>".

Examples

-------------- EXAMPLE 1 --------------

This command uses Get-Connector to retrieve a connector with a display name of "test connector". It then uses Get-Tier along with Where-Object to retrieve a tier named 'Test Tier'. Last, it uses Remove-ConnectorFromTier to remove the connector from the tier.

C:\PS>$connector = get-connector |
where-object {$_.displayname -eq 'test connector'}
$tier = get-tier | where-object {$_.name -eq 'Test Tier'}
remove-connectorfromtier -connector $connector -tier $tier

Add-ConnectorToTier