Update-SCOMRunAsAccount
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 |