Add-SCOMADAgentAssignment
AD DS エージェントで管理されているコンピューターを管理グループに割り当てます。
構文
Add-SCOMADAgentAssignment
[-Domain] <String>
[-PrimaryServer] <ManagementServer>
[-LdapQuery] <String>
[-RunAsProfile <ManagementPackSecureReference>]
[-FailoverServer <ManagementServer[]>]
[-Exclude <String[]>]
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] 説明
Add-SCOMADAgentAssignment コマンドレットは、1 つ以上の Active Directory Domain Services (AD DS) エージェントで管理されるコンピューターを System Center - Operations Manager 管理グループに割り当てます。
このコマンドレットを使用してエージェントで管理されるコンピューターを管理グループに割り当てる前に、MOMADAdmin.exe を使用して、コンピューターのドメインに Operations Manager 管理グループの AD DS コンテナーを作成します。
例
例 1: AD DS エージェントで管理されているコンピューターを管理グループに割り当てる
PS C:\>$PrimaryServer = Get-SCOMManagementServer -Name "DivMgmtSvr01.fabrikam.net"
PS C:\> $Ldap = "(&(sAMAccountType=805306369)(name=SQLServer*))"
PS C:\> Add-SCOMADAgentAssignment -Domain "fabrikam.net" -PrimaryServer $PrimaryServer -LdapQuery $Ldap -Exclude "SQLServer05.fabrikam.net"この例では、AD DS エージェントで管理されているコンピューターを管理グループに割り当てます。
最初のコマンドは、DivMgmtSvr01.fabrikam.net という名前の管理サーバー オブジェクトを取得し、そのオブジェクトを $PrimaryServer 変数に格納します。
2 番目のコマンドは、SQLServer*.fabrikam.net などの名前のコンピューターを選択し、$Ldap変数にオブジェクトを格納する LDAP クエリを指定します。
3 番目のコマンドは、$Ldapに格納されている AD DS エージェントで管理されたコンピューターを、fabrikam.net ドメインの管理グループに割り当てます。 このコマンドは、SQLServer05.fabrikam.net という名前のコンピューターを管理グループから除外します。
例 2: AD DS エージェントの割り当てのフェールオーバーを設定する
PS C:\>$PrimaryServer = Get-SCOMManagementServer -Name "DivMgmtSvr01.fabrikam.net"
PS C:\> $Failovers = Get-SCOMManagementServer -Name "FabrikamSecondary*.fabrikam.net"
PS C:\> $RunAs = Get-SCOMRunAsProfile -Name "Active Directory Based Agent Assignment Account"
PS C:\> $Ldap = "(&(sAMAccountType=805306369)(name=SQLServer*))"
PS C:\> Add-SCOMADAgentAssignment -Domain "fabrikam.net" -PrimaryServer $PrimaryServer -LdapQuery $Ldap -FailoverServer $Failovers -RunAsProfile $RunAsこの例では、AD DS エージェントで管理されているコンピューターを管理グループに割り当て、エージェントのフェールオーバーを設定します。
最初のコマンドは、DivMgmtSvr01.fabrikam.net という名前の管理サーバー オブジェクトを取得し、そのオブジェクトを $PrimaryServer 変数に格納します。
2 番目のコマンドは、FabrikamSecondary*.fabrikam.net などの名前の管理サーバーを取得し、$Failovers変数にオブジェクトを格納します。
3 番目のコマンドは、"Active Directory ベースのエージェント割り当てアカウント" という名前の実行プロファイル オブジェクトを取得し、$RunAs変数にオブジェクトを格納します。
4 番目のコマンドは、SQLServer*.fabrikam.net などの名前のコンピューターを選択し、結果を $Ldap 変数に格納する LDAP クエリを指定します。
5 番目のコマンドは、$Ldapに格納されている AD DS エージェントで管理されたコンピューターを、fabrikam.net ドメインの管理グループに割り当てます。 このコマンドは、エージェントが管理するコンピューターの$PrimaryServerに格納されているプライマリ管理サーバーを指定します。 このコマンドは、エージェントが管理するコンピューターのフェールオーバーとして、$Failoversに格納されている管理サーバーを指定します。 このコマンドは、エージェントが管理するコンピューターの$RunAsに格納されている実行プロファイルを指定します。
パラメーター
-ComputerName
コンピューターの名前の配列を指定します。 NetBIOS 名、IP アドレス、または完全修飾ドメイン名 (FQDN) を使用できます。 ローカル コンピューターを指定するには、コンピューター名、localhost、またはドット (.) を入力します。
System Center Data Access サービスがコンピューター上で実行されている必要があります。 コンピューターを指定しない場合、コマンドレットは現在の管理グループ接続にコンピューターを使用します。
| 型: | String[] |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Confirm
コマンドレットを実行する前に確認を求めるメッセージが表示されます。
| 型: | SwitchParameter |
| Aliases: | cf |
| 配置: | Named |
| 規定値: | False |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Credential
管理グループ接続 PSCredential オブジェクトを指定します。
PSCredential オブジェクトを取得するには、Get-Credential コマンドレットを使用します。
詳細については、「Get-Help Get-Credential」と入力します。
ComputerName パラメーターでコンピューターを指定する場合は、そのコンピューターにアクセスできるアカウントを使用します。 既定値は現在のユーザーです。
| 型: | PSCredential |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Domain
ターゲット エージェントが存在するドメインまたはドメイン コントローラーの名前を指定します。
| 型: | String |
| Aliases: | DC |
| 配置: | 1 |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Exclude
コンピューターの名前の配列を指定します。 Operations Manager は、指定したコンピューターをエージェントの割り当てから除外します。
| 型: | String[] |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-FailoverServer
ManagementServer オブジェクトの名前の配列
既定では、Operations Manager では、ゲートウェイ以外のすべての管理サーバーがフェールオーバーに使用されます。
| 型: | ManagementServer[] |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-LdapQuery
ターゲット エージェント コンピューターを選択するドメイン内の LDAP クエリを指定します。
| 型: | String |
| 配置: | 3 |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-PrimaryServer
ManagementServer オブジェクトを指定します。 このパラメーターは、ターゲット エージェントで管理されるコンピューターのプライマリ管理サーバーを指定します。 ManagementServer オブジェクトを取得するには、Get-SCOMManagementServer コマンドレットを使用します。
| 型: | ManagementServer |
| 配置: | 2 |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-RunAsProfile
Operations Manager が AD DS クエリ ワークフローの実行に使用する実行プロファイルを指定します。
実行プロファイルは、MOMADAdmin.exe を実行して System Center - Operations Manager 管理グループの AD DS コンテナーを作成するときに指定したのと同じ実行アカウントに関連付ける必要があります。
| 型: | ManagementPackSecureReference |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-SCSession
Connection オブジェクトの配列
接続オブジェクトは、管理サーバーへの接続を表します。 既定値は、現在の管理グループ接続です。
| 型: | Connection[] |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-WhatIf
コマンドレットを実行した場合の動作を示します。 コマンドレットは実行されません。
| 型: | SwitchParameter |
| Aliases: | wi |
| 配置: | Named |
| 規定値: | False |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |