次の方法で共有

Update-SCOMRunAsAccount

  • リファレンス
モジュール:
OperationsManager

Operations Manager 実行アカウントの資格情報を更新します。

構文

Update-SCOMRunAsAccount
      [-WindowsAccount] <WindowsCredentialSecureData>
      [-RunAsCredential] <PSCredential>
      [-AccountType <String>]
      [-PassThru]
      [-SCSession <Connection[]>]
      [-ComputerName <String[]>]
      [-Credential <PSCredential>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Update-SCOMRunAsAccount
      [-BasicAccount] <BasicCredentialSecureData>
      [-RunAsCredential] <PSCredential>
      [-AccountType <String>]
      [-PassThru]
      [-SCSession <Connection[]>]
      [-ComputerName <String[]>]
      [-Credential <PSCredential>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Update-SCOMRunAsAccount
      [-SimpleAccount] <SimpleCredentialSecureData>
      [-RunAsCredential] <PSCredential>
      [-AccountType <String>]
      [-PassThru]
      [-SCSession <Connection[]>]
      [-ComputerName <String[]>]
      [-Credential <PSCredential>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Update-SCOMRunAsAccount
      [-DigestAccount] <DigestCredentialSecureData>
      [-RunAsCredential] <PSCredential>
      [-AccountType <String>]
      [-PassThru]
      [-SCSession <Connection[]>]
      [-ComputerName <String[]>]
      [-Credential <PSCredential>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Update-SCOMRunAsAccount
      [-ActionAccount] <ActionAccountSecureData>
      [-RunAsCredential] <PSCredential>
      [-AccountType <String>]
      [-PassThru]
      [-SCSession <Connection[]>]
      [-ComputerName <String[]>]
      [-Credential <PSCredential>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Update-SCOMRunAsAccount
      [-CommunityStringAccount] <CommunityStringSecureData>
      [-CommunityString] <SecureString>
      [-AccountType <String>]
      [-PassThru]
      [-SCSession <Connection[]>]
      [-ComputerName <String[]>]
      [-Credential <PSCredential>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Update-SCOMRunAsAccount
      [-BinaryAccount] <GenericSecureData>
      [-Path] <String>
      [-AccountType <String>]
      [-PassThru]
      [-SCSession <Connection[]>]
      [-ComputerName <String[]>]
      [-Credential <PSCredential>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

説明

Update-SCOMRunAsAccount コマンドレットは、System Center - Operations Manager 実行アカウントの資格情報を更新します。 実行アカウントを使用すると、ユーザーは、必要に応じて特定のコンピューターを対象とするルール、タスク、モニター、検出で使用するために必要なアクセス許可を指定できます。

このコマンドレットは、SCX (クロスプラットフォーム) アカウントまたは Simple Network Management Protocol バージョン 3 (SNMPv3) アカウントをサポートしていません。 代わりに、 Get-SCOMRunAsAccount を使用して SCX アカウントを更新します。

例

例 1: Windows 実行アカウントを更新する

PS C:\>$WindowsAccount = Get-SCOMRunAsAccount -Name "Domain Admin"
PS C:\>$WindowsAccount | Update-SCOMRunAsAccount -RunAsCredential (Get-Credential)

次の使用例は、Windows 実行アカウントを更新します。

最初のコマンドは、Domain 管理 という名前の実行アカウント オブジェクトを取得し、そのオブジェクトを $WindowsAccount 変数に格納します。

2 番目のコマンドは、パイプライン演算子を使用して、$WindowsAccount変数に格納されている実行アカウントを Update-SCOMRunAsAccount コマンドレットに渡します。 このコマンドレットは、 Get-Credential コマンドレットのプロンプトに応答して、ユーザーが提供するユーザー名とパスワードにアカウントの資格情報を更新します。

例 2: アクション実行アカウントを更新する

PS C:\>$UserName = "Contoso\SCOMActionAccount"
PS C:\>$Password = Read-Host -AsSecureString
PS C:\>$NewCred = new-object System.Management.Automation.PsCredential $UserName,$Password
PS C:\>Get-SCOMRunAsAccount -Name "SCOM Action Account" | Update-SCOMRunAsAccount -RunAsCredential $newCred

次の使用例は、アクション実行アカウントの資格情報を更新します。

最初のコマンドは、アクション アカウント名を含む文字列を作成し、その文字列を $UserName 変数に格納します。

2 番目のコマンドは、パスワードを表す文字列を入力するようにユーザーに求めます。 次に、ユーザー入力をセキュリティで保護された文字列として $Password 変数に格納します。

3 番目のコマンドは、$UserName変数に格納されている名前と、$Passwordに格納されているパスワードを使用して PSCredential オブジェクトを作成します。 次に、 PSCredential オブジェクトを $NewCred 変数に格納します。

最後のコマンドは、SCOM アクション アカウントという名前のアクション アカウントを取得します。 その後、パイプライン演算子を使用してアカウントを Update-SCOMRunAsAccount コマンドレットに渡します。このコマンドレットは、$NewCred変数に格納されている資格情報を使用してアカウントを更新します。

例 3: コミュニティ文字列アカウントを更新する

PS C:\>Get-SCOMRunAsAccount -Name "MyCommunityStringAccount" | Update-SCOMRunAsAccount -CommunityString (Read-Host -AsSecureString)

このコマンドは、SNMP バージョン 2 のコミュニティ文字列認証を使用する実行アカウントの資格情報を更新します。 MyCommunityStringAccount という名前のコミュニティ文字列アカウントを取得し、パイプライン演算子を使用してアカウントを Update-SCOMRunAsAccount コマンドレットに渡します。 このコマンドレットは、 Read-Host コマンドレットからのプロンプトに応じてユーザーが入力した値でコミュニティ文字列を更新します。 詳細を表示するには「Get-Help Read-Host」を入力します。

例 4: バイナリ認証アカウントを更新する

PS C:\>Get-SCOMRunAsAccount -Name "MyBinaryAccount" | Update-SCOMRunAsAccount -Path ".\data.txt"

この例では、MyBinaryAccount という名前のバイナリ アカウント オブジェクトを取得し、パイプライン演算子を使用してオブジェクトを Update-SCOMRunAsAccount コマンドレットに渡します。 このコマンドレットは 、Path パラメーターを使用して、data.txt という名前のファイルから新しいアカウント データを取得することを示します。

パラメーター

-AccountType

実行アカウントの種類を指定します。 パイプラインは通常、この値を自動的に設定します。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ActionAccount

アクション アカウントを実行アカウントとして指定します。

Type:ActionAccountSecureData
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-BasicAccount

基本認証を使用する実行アカウントを指定します。

Type:BasicCredentialSecureData
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-BinaryAccount

バイナリ認証を使用する実行アカウントを指定します。

Type:GenericSecureData
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-CommunityString

コミュニティ文字列認証を使用する SNMP バージョン 2 実行アカウントの新しいコミュニティ文字列を指定します。

Type:SecureString
Position:2
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-CommunityStringAccount

コミュニティ文字列認証を使用する SNMP バージョン 2 実行アカウントを指定します。

Type:CommunityStringSecureData
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-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

管理グループ接続を実行するユーザー アカウントを指定します。 このパラメーターに対して、Get-Credential コマンドレットから返される 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

-DigestAccount

標準ダイジェスト Web 認証を使用する実行アカウントを指定します。

Type:DigestCredentialSecureData
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-PassThru

コマンドレットが、パイプラインでコマンドで使用できるオブジェクトを作成または変更することを示します。 既定では、このコマンドレットによる出力はありません。

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Path

バイナリ認証を使用する実行アカウントの新しい資格情報データを含むファイルへのパスを指定します。

Type:String
Position:2
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-RunAsCredential

ユーザー名とパスワードを使用するアカウントの種類の新しい資格情報を指定します。

Type:PSCredential
Position:2
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-SCSession

Connection オブジェクトの配列を指定します。 Connection オブジェクトを取得するには、Get-SCOMManagementGroupConnection コマンドレットを使用します。

このパラメーターを指定しない場合、コマンドレットは管理グループへのアクティブな永続的な接続を使用します。 SCSession パラメーターを使用して、別の永続的な接続を指定します。 ComputerName パラメーターと Credential パラメーターを使用して、管理グループへの一時的な接続を作成できます。 詳細を表示するには「Get-Help about_OpsMgr_Connections」を入力します。

Type:Connection[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SimpleAccount

単純な Web 認証を使用する実行アカウントを指定します。

Type:SimpleCredentialSecureData
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

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

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

-WindowsAccount

Windows 認証を使用する実行アカウントを指定します。

Type:WindowsCredentialSecureData
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False