Update-SCOMRunAsAccount
更新 Operations Manager 运行方式帐户的凭据。
语法
WindowsAccount
Update-SCOMRunAsAccount
[-WindowsAccount] <WindowsCredentialSecureData>
[-RunAsCredential] <PSCredential>
[-AccountType <String>]
[-PassThru]
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
BasicAccount
Update-SCOMRunAsAccount
[-BasicAccount] <BasicCredentialSecureData>
[-RunAsCredential] <PSCredential>
[-AccountType <String>]
[-PassThru]
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
SimpleAccount
Update-SCOMRunAsAccount
[-SimpleAccount] <SimpleCredentialSecureData>
[-RunAsCredential] <PSCredential>
[-AccountType <String>]
[-PassThru]
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
DigestAccount
Update-SCOMRunAsAccount
[-DigestAccount] <DigestCredentialSecureData>
[-RunAsCredential] <PSCredential>
[-AccountType <String>]
[-PassThru]
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
ActionAccount
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>]
BinaryAccount
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
|
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | True |
| 来自剩余参数的值: | False |
-ActionAccount
将操作帐户指定为运行方式帐户。
参数属性
| 类型: | ActionAccountSecureData
|
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
ActionAccount
| Position: | 1 |
| 必需: | True |
| 来自管道的值: | True |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-BasicAccount
指定使用基本身份验证的运行方式帐户。
参数属性
| 类型: | BasicCredentialSecureData
|
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
BasicAccount
| Position: | 1 |
| 必需: | True |
| 来自管道的值: | True |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-BinaryAccount
指定使用二进制身份验证的运行方式帐户。
参数属性
| 类型: | GenericSecureData
|
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
BinaryAccount
| Position: | 1 |
| 必需: | True |
| 来自管道的值: | True |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
为使用社区字符串身份验证的 SNMP 版本 2 运行方式帐户指定新的社区字符串。
| 类型: | SecureString
|
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
CommunityStringAccount
| Position: | 2 |
| 必需: | True |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
指定使用社区字符串身份验证的 SNMP 版本 2 运行方式帐户。
| 类型: | CommunityStringSecureData
|
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
CommunityStringAccount
| Position: | 1 |
| 必需: | True |
| 来自管道的值: | True |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-ComputerName
指定计算机名称数组。
该 cmdlet 与这些计算机的管理组建立临时连接。
可以使用 NetBIOS 名称、IP 地址或完全限定的域名(FQDN)。
若要指定本地计算机,请键入计算机名称、localhost 或点(.)。
必须在计算机上启动 System Center Data Access 服务。
如果未指定计算机,该 cmdlet 将使用计算机进行当前管理组连接。
参数属性
| 类型: | String[]
|
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-Confirm
在运行 cmdlet 之前,提示你进行确认。
参数属性
| 类型: | SwitchParameter
|
| 默认值: | False |
| 支持通配符: | False |
| 不显示: | False |
| 别名: | cf |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-Credential
指定运行管理组连接的用户帐户。
为此参数指定 PSCredential 对象,例如 Get-Credential cmdlet 返回的对象。
有关凭据对象的详细信息,请键入 Get-Help Get-Credential。
如果在 ComputerName 参数中指定计算机,请使用有权访问该计算机的帐户。
默认值为当前用户。
参数属性
| 类型: | PSCredential
|
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-DigestAccount
指定使用标准摘要 Web 身份验证的运行方式帐户。
参数属性
| 类型: | DigestCredentialSecureData
|
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
DigestAccount
| Position: | 1 |
| 必需: | True |
| 来自管道的值: | True |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-PassThru
指示 cmdlet 创建或修改命令可以在管道中使用的对象。
默认情况下,此 cmdlet 不生成任何输出。
参数属性
| 类型: | SwitchParameter
|
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-Path
指定包含使用二进制身份验证的运行方式帐户的新凭据数据的文件的路径。
参数属性
| 类型: | String
|
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
BinaryAccount
| Position: | 2 |
| 必需: | True |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-RunAsCredential
为使用用户名和密码的帐户类型指定新凭据。
参数属性
| 类型: | PSCredential
|
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
WindowsAccount
| Position: | 2 |
| 必需: | True |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
BasicAccount
| Position: | 2 |
| 必需: | True |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
SimpleAccount
| Position: | 2 |
| 必需: | True |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
DigestAccount
| Position: | 2 |
| 必需: | True |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
ActionAccount
| Position: | 2 |
| 必需: | True |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-SCSession
指定 连接 对象的数组。
若要获取 连接 对象,请使用 Get-SCOMManagementGroupConnection cmdlet。
如果未指定此参数,cmdlet 将使用与管理组的活动持久连接。
使用 SCSession 参数指定不同的持久连接。
可以使用 ComputerName 和 Credential 参数创建与管理组的临时连接。
有关详细信息,请键入 Get-Help about_OpsMgr_Connections。
参数属性
| 类型: | Connection[]
|
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-SimpleAccount
指定使用简单 Web 身份验证的运行方式帐户。
参数属性
| 类型: | SimpleCredentialSecureData
|
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
SimpleAccount
| Position: | 1 |
| 必需: | True |
| 来自管道的值: | True |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-WhatIf
显示 cmdlet 运行时会发生什么情况。
cmdlet 未运行。
参数属性
| 类型: | SwitchParameter
|
| 默认值: | False |
| 支持通配符: | False |
| 不显示: | False |
| 别名: | 无线 |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-WindowsAccount
指定使用 Windows 身份验证的运行方式帐户。
参数属性
| 类型: | WindowsCredentialSecureData
|
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
WindowsAccount
| Position: | 1 |
| 必需: | True |
| 来自管道的值: | True |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
CommonParameters
此 cmdlet 支持通用参数:-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息,请参阅 about_CommonParameters。