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.
このコマンドレットは出力を生成しません。