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 cmdlet 更新 System Center - Operations Manager 运行方式帐户的凭据。 运行方式帐户使用户能够根据需要指定用于特定计算机的规则、任务、监视器和发现所需的权限。

此 cmdlet 不支持 SCX（跨平台）帐户或简单网络管理协议版本 3（SNMPv3）帐户。 相反，Get-SCOMRunAsAccount 更新 SCX 帐户。

示例

示例 1：更新 Windows 运行方式帐户

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

此示例更新 Windows 运行方式帐户。

第一个命令获取名为域管理员的运行方式帐户对象，并将该对象存储在$WindowsAccount变量中。

第二个命令使用管道运算符将存储在$WindowsAccount变量中的运行方式帐户传递给 Update-SCOMRunAsAccount cmdlet。 该 cmdlet 通过响应 Get-Credential cmdlet 中的提示，将帐户的凭据更新为用户提供的用户名和密码。

示例 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变量中。

第二个命令提示用户输入表示密码的字符串。 然后，它将用户输入存储为$Password变量中的安全字符串。

第三个命令使用存储在$UserName变量中的名称和存储在$Password中的密码来创建 PSCredential 对象。 然后，它将 PSCredential 对象存储在$NewCred变量中。

最后一个命令获取名为 SCOM 操作帐户的操作帐户。 然后，它使用管道运算符将帐户传递给 Update-SCOMRunAsAccount cmdlet，该 cmdlet 使用存储在$NewCred变量中的凭据更新帐户。

示例 3：更新社区字符串帐户

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

此命令更新运行方式帐户的凭据，该帐户使用 SNMP 版本 2 的社区字符串身份验证。 它获取名为 MyCommunityStringAccount 的社区字符串帐户，并使用管道运算符将帐户传递给 Update-SCOMRunAsAccount cmdlet。 此 cmdlet 使用用户输入的值更新社区字符串，以响应来自 Read-Host cmdlet 的提示。 有关详细信息，请键入 Get-Help Read-Host。

示例 4：更新二进制身份验证帐户

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

此示例获取名为 MyBinaryAccount 的二进制帐户对象，并使用管道运算符将对象传递给 Update-SCOMRunAsAccount cmdlet。 此 cmdlet 使用 Path 参数来指示它从名为 data.txt的文件获取新帐户数据。

参数

-AccountType

指定运行方式帐户的类型。 管道通常会自动填充此值。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	True
接受通配符:	False

-ActionAccount

将操作帐户指定为运行方式帐户。

类型:	ActionAccountSecureData
Position:	1
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

-BasicAccount

指定使用基本身份验证的运行方式帐户。

类型:	BasicCredentialSecureData
Position:	1
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

-BinaryAccount

指定使用二进制身份验证的运行方式帐户。

类型:	GenericSecureData
Position:	1
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

-CommunityString

为使用社区字符串身份验证的 SNMP 版本 2 运行方式帐户指定新的社区字符串。

类型:	SecureString
Position:	2
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-CommunityStringAccount

指定使用社区字符串身份验证的 SNMP 版本 2 运行方式帐户。

类型:	CommunityStringSecureData
Position:	1
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

-ComputerName

指定计算机名称数组。 该 cmdlet 与这些计算机的管理组建立临时连接。 可以使用 NetBIOS 名称、IP 地址或完全限定的域名（FQDN）。 若要指定本地计算机，请键入计算机名称、localhost 或点（.）。

必须在计算机上启动 System Center Data Access 服务。 如果未指定计算机，该 cmdlet 将使用计算机进行当前管理组连接。

类型:	String[]
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Confirm

在运行 cmdlet 之前，提示你进行确认。

类型:	SwitchParameter
别名:	cf
Position:	Named
默认值:	False
必需:	False
接受管道输入:	False
接受通配符:	False

-Credential

指定运行管理组连接的用户帐户。 为此参数指定 PSCredential 对象，例如 Get-Credential cmdlet 返回的对象。 有关凭据对象的详细信息，请键入 Get-Help Get-Credential。

如果在 ComputerName 参数中指定计算机，请使用有权访问该计算机的帐户。 默认值为当前用户。

类型:	PSCredential
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-DigestAccount

指定使用标准摘要 Web 身份验证的运行方式帐户。

类型:	DigestCredentialSecureData
Position:	1
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

-PassThru

指示 cmdlet 创建或修改命令可以在管道中使用的对象。 默认情况下，此 cmdlet 不生成任何输出。

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Path

指定包含使用二进制身份验证的运行方式帐户的新凭据数据的文件的路径。

类型:	String
Position:	2
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-RunAsCredential

为使用用户名和密码的帐户类型指定新凭据。

类型:	PSCredential
Position:	2
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-SCSession

指定 连接 对象的数组。 若要获取 连接 对象，请使用 Get-SCOMManagementGroupConnection cmdlet。

如果未指定此参数，cmdlet 将使用与管理组的活动持久连接。 使用 SCSession 参数指定不同的持久连接。 可以使用 ComputerName 和 Credential 参数创建与管理组的临时连接。 有关详细信息，请键入 Get-Help about_OpsMgr_Connections。

类型:	Connection[]
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-SimpleAccount

指定使用简单 Web 身份验证的运行方式帐户。

类型:	SimpleCredentialSecureData
Position:	1
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

-WhatIf

显示 cmdlet 运行时会发生什么情况。 cmdlet 未运行。

类型:	SwitchParameter
别名:	wi
Position:	Named
默认值:	False
必需:	False
接受管道输入:	False
接受通配符:	False

-WindowsAccount

指定使用 Windows 身份验证的运行方式帐户。

类型:	WindowsCredentialSecureData
Position:	1
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

相关链接

• Add-SCOMRunAsAccount
• Get-SCOMRunAsAccount