Update-SCSMConnector
Service Manager コネクタのプロパティを更新します。
構文
Update-SCSMConnector
[-Connector] <Connector[]>
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
説明
Update-SCSMConnector コマンドレットは、Service Manager コネクタのプロパティを更新します。
たとえば、[ を有効にする] プロパティを$Falseに設定してコネクタを無効にしたり、$Trueに設定してコネクタを有効にしたりすることができます。
このコマンドレットは、Get-SCSMConnector コマンドレットと組み合わせて使用します。
Get-SCSmConnector
スケジュール プロパティは、Service Manager 2012 R2 更新プログラムロールアップ 6 以降を適用している場合にのみ使用できます。
コネクタの種類ごとに、次のプロパティを更新できます。
Active Directory コネクタ
- 形容
- エネーブル
- 名前
- RunAsAccount
- SelectedObjects
- 計画
Configuration Manager コネクタ
- コレクション
- 形容
- エネーブル
- 名前
- RunAsAccount
- 計画
Operations Manager Alert Connector
- 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のプロパティ
最後のコマンドは、コネクタを $AlertConnector の現在の値に更新します。
パラメーター
-Confirm
コマンドレットを実行する前に確認を求めるメッセージが表示されます。
型: | System.Management.Automation.SwitchParameter |
Aliases: | cf |
配置: | Named |
規定値: | False |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Connector
Service Manager コネクタを表すオブジェクトを指定します。
型: | Microsoft.EnterpriseManagement.ServiceManager.Sdk.Connectors.Connector[] |
配置: | 0 |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-PassThru
このコマンドレットは、更新されたコネクタを返します。 このオブジェクトは、他のコマンドレットに渡すことができます。
型: | System.Management.Automation.SwitchParameter |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-WhatIf
コマンドレットを実行した場合の動作を示します。 コマンドレットは実行されません。
型: | System.Management.Automation.SwitchParameter |
Aliases: | wi |
配置: | Named |
規定値: | False |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
入力
Microsoft.EnterpriseManagement.ServiceManager.Sdk.Connectors.Connector
コネクタをパイプ処理して、Connector パラメーターに渡すことができます。
出力
None.
このコマンドレットは出力を生成しません。