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 ベースのエージェント割り当てアカウント" という名前の Runs As プロファイル オブジェクトを取得し、オブジェクトを $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 サービスがコンピューター上で実行されている必要があります。 コンピューターを指定しない場合、コマンドレットは現在の管理グループ接続にコンピューターを使用します。
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Confirm
コマンドレットの実行前に確認を求めるメッセージが表示されます。
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Credential
管理グループ接続の PSCredential オブジェクトを指定します。
PSCredential オブジェクトを取得するには、Get-Credential コマンドレットを使用します。
詳細を表示するには「Get-Help Get-Credential」を入力します。
ComputerName パラメーターでコンピューターを指定する場合は、そのコンピューターにアクセスできるアカウントを使用します。 既定値は現在のユーザーです。
| Type: | PSCredential |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Domain
ターゲット エージェントが存在するドメインまたはドメイン コントローラーの名前を指定します。
| Type: | String |
| Aliases: | DC |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Exclude
コンピューターの名前の配列を指定します。 Operations Manager は、指定したコンピューターをエージェントの割り当てから除外します。
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-FailoverServer
ManagementServer オブジェクトの名前の配列を指定します。 このパラメーターは、Operations Manager がターゲット エージェントのフェールオーバーとして使用する管理サーバーを指定します。
既定では、Operations Manager では、フェールオーバーにゲートウェイ以外のすべての管理サーバーが使用されます。
| Type: | ManagementServer[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-LdapQuery
ターゲット エージェント コンピューターを選択するドメイン内の LDAP クエリを指定します。
| Type: | String |
| Position: | 3 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PrimaryServer
ManagementServer オブジェクトを指定します。 このパラメーターは、ターゲット エージェントで管理されるコンピューターのプライマリ管理サーバーを指定します。 ManagementServer オブジェクトを取得するには、Get-SCOMManagementServer コマンドレットを使用します。
| Type: | ManagementServer |
| Position: | 2 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RunAsProfile
Operations Manager が AD DS クエリ ワークフローの実行に使用する実行プロファイルを指定します。
実行プロファイルは、MOMADAdmin.exe を実行して System Center - Operations Manager 管理グループの AD DS コンテナーを作成するときに指定したのと同じ RunAs アカウントに関連付ける必要があります。
| Type: | ManagementPackSecureReference |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-SCSession
Connection オブジェクトの配列を指定します。 Connection オブジェクトを取得するには、Get-SCOMManagementGroupConnection コマンドレットを使用します。
接続オブジェクトは、管理サーバーへの接続を表します。 既定値は現在の管理グループ接続です。
| Type: | Connection[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-WhatIf
コマンドレットの実行時に発生する内容を示します。 このコマンドレットは実行されません。
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |