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 运行方式帐户。

第一个命令获取名为 Domain 管理员 的运行方式帐户对象，并将该对象存储在 $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，后者使用存储在 $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

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

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

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

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

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

-Confirm

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

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

-Credential

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

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

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 cmdlet。

如果未指定此参数，则 cmdlet 将使用与管理组的活动持久连接。 使用 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

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

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

相关链接

• Add-SCOMRunAsAccount
• Get-SCOMRunAsAccount