Update-SCSMConnector

Service Manager コネクタのプロパティを更新します。

構文

Update-SCSMConnector
      [-Connector] <Connector[]>
      [-PassThru]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

説明

Update-SCSMConnector コマンドレットは、Service Manager コネクタのプロパティを更新します。 たとえば、 Enable プロパティを $False に設定してコネクタを無効にしたり、$Trueに設定してコネクタを有効にすることができます。 このコマンドレットは、Get-SCSMConnector コマンドレットと組み合わせて使用します。 Get-SCSmConnector がオブジェクトを取得したら、オブジェクトのプロパティを変更し、現在のコマンドレットに渡すことができます。 このコマンドレットは、プロパティを更新します。

schedule プロパティは、2012 R2 更新プログラムロールアップ 6 以降Service Manager適用している場合にのみ使用できます。

コネクタの種類ごとに、次のプロパティを更新できます。

Active Directory コネクタ

  • 説明
  • 有効化
  • 名前
  • RunAsAccount
  • SelectedObjects
  • スケジュール

Configuration Manager コネクタ

  • コレクション
  • 説明
  • 有効化
  • 名前
  • RunAsAccount
  • スケジュール

Operations Manager アラート コネクタ

  • CloseAlert
  • 説明
  • 有効化
  • 名前
  • ResolveIncident
  • ルール
  • RunAsAccount
  • スケジュール
  • テンプレート

Operations Manager CI コネクタ

  • 説明
  • 有効化
  • 名前
  • OperationsManagerServer
  • RunAsAccount
  • スケジュール

例 1: Active Directory コネクタのオブジェクトを更新する

PS C:\>$RunAsAccount = Get-SCSMRunAsAccount -RunAsProfileName "NewProfile"
PS C:\> $ADConnector = Get-SCSMConnector -Name "WOODGROVE Active Directory"
PS C:\> $ADConnector.Select = "(&(objectCategory=computer)(name=*fulle*))"
PS C:\> Get-SCSMConnector | ForEach-Object { $_.RunAsAccount = $RunAsAccount } | Update-SCSMConnector

次の使用例は、Active Directory コネクタの選択したオブジェクトを更新します。 最初のコマンドは、Get-SCSMRunAsAccount コマンドレットを使用して実行アカウントを取得し、$RunAsAccount変数に格納します。

2 番目のコマンドは 、Get-SCSMConnector コマンドレットを使用してコネクタを取得し、$ADConnector変数に格納します。

3 番目のコマンドは、$ADConnectorの Select プロパティに値を割り当てます。

最後のコマンドはすべてのコネクタを取得し、$RunAsAccountを実行アカウントとして使用するコネクタを現在のコマンドレットに渡します。 このコマンドレットは、コネクタを更新します。

例 2: コネクタの実行アカウントを更新する

PS C:\>$RunAsAccount = Get-SCSMRunAsAccount -RunAsProfileName "NewProfile"
PS C:\> Get-SCSMConnector | ForEach-Object { $_.RunAsAccount = $RunAsAccount } | Update-SCSMConnector

最初のコマンドは、プロファイル名 NewProfile を持つ実行アカウントを取得し、結果を $RunAsAccount 変数に格納します。

2 番目のコマンドは、$RunAsAccountの実行アカウントを持つすべてのコネクタを更新します。

例 3: Operations Manager アラート コネクタを更新する

PS C:\>$AlertConnector = Get-SCSMConnector "Alert Connector"
PS C:\>$AlertConnector.rules += New-SCSMAlertRule @{
>> Name = "newRule"
>> Template = Get-SCSMObjectTemplate -Name ".*IncidentTemplate.*"
>> ManagementPack = Get-SCManagementPack "System.Library"
>>}
PS C:\>Update-SCSMConnector -Connector $AlertConnector

次の使用例は、Operations Manager アラート コネクタに新しいルールを追加します。 最初のコマンドはコネクタを取得し、$AlertConnector変数に格納します。

2 番目のコマンドは、$AlertConnectorの rules プロパティにルールを追加します。 New-SCSMAlertRule コマンドレットによってルールが作成されます。 このコマンドは、複数行にわたって拡張されます。

最後のコマンドは、コネクタを$AlertConnectorの現在の値に更新します。

パラメーター

-Confirm

コマンドレットの実行前に確認を求めるメッセージが表示されます。

Type:System.Management.Automation.SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Connector

Service Manager コネクタを表すオブジェクトを指定します。

Type:Microsoft.EnterpriseManagement.ServiceManager.Sdk.Connectors.Connector[]
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-PassThru

このコマンドレットによって、更新されたコネクタが返されることを示します。 このオブジェクトは、他のコマンドレットに渡すことができます。

Type:System.Management.Automation.SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

コマンドレットの実行時に発生する内容を示します。 このコマンドレットは実行されません。

Type:System.Management.Automation.SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

入力

Microsoft.EnterpriseManagement.ServiceManager.Sdk.Connectors.Connector

コネクタを コネクタ パラメーターに パイプ処理できます。

出力

None.

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