Set-SPPassPhrase

适用于： SharePoint Foundation 2010, SharePoint Server 2010

上一次修改主题： 2015-03-09

将密码设置为一个新值。

Set-SPPassPhrase -ConfirmPassPhrase <SecureString> -PassPhrase <SecureString> [-AssignmentCollection <SPAssignmentCollection>] [-Confirm [<SwitchParameter>]] [-WhatIf [<SwitchParameter>]]

Set-SPPassPhrase -PassPhrase <SecureString> [-AssignmentCollection <SPAssignmentCollection>] [-Confirm [<SwitchParameter>]] [-LocalServerOnly <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

Set-SPPassPhrase cmdlet 可将密码设置为新的密码值。如果不使用 LocalServerOnly 参数，将使用新值重新加密服务器场加密密钥，并尝试将此值传播到服务器场中的所有其他服务器。如果使用 LocalServerOnly 参数，则仅在本地计算机上进行更新，而不更改服务器场加密密钥。服务器场中所有服务器上的密码值必须相同，服务器场才能正常运行。因此，如果未能将密码传播到所有服务器，则可以使用 LocalServerOnly 参数将其余服务器手动设置为新的密码值。

参数	是否必需	类型	说明
ConfirmPassphrase	必需	System.Security.SecureString
Passphrase	必需	System.SecuritySecureString	指定新的密码值。
AssignmentCollection	可选	Microsoft.SharePoint.PowerShell.SPAssignmentCollection	管理对象以便正确进行处理。使用 SPWeb 或 SPSite 等对象可能会耗用大量内存，而且在 Windows PowerShell 脚本中使用这些对象需要正确管理内存。通过使用 SPAssignment 对象，可以将对象分配给变量，然后在不需要这些对象时对它们进行处理，以释放内存。在使用 SPWeb、SPSite 或 SPSiteAdministration 对象时，如果不使用分配集合或 Global 参数，则会自动处理这些对象。 Note 在使用 Global 参数时，所有对象均包含在全局存储中。如果未立即使用对象，或未通过使用 Stop-SPAssignment 命令来处理对象，则可能会发生内存不足的情况。
Confirm	可选	System.Management.Automation.SwitchParameter	在执行命令之前提示您确认。有关详细信息，请键入以下命令：get-help about_commonparameters
LocalServerOnly	可选	System.Management.Automation.SwitchParameter	将密码更改的范围限制为仅可在本地服务器上更改。如果不使用此参数，将在整个服务器场范围内执行密码更改。
WhatIf	可选	System.Management.Automation.SwitchParameter	显示一条描述命令作用的消息，而不执行命令。有关详细信息，请键入以下命令：get-help about_commonparameters

------------------示例-----------------------

$passphrase = ConvertTo-SecureString -asPlainText -Force

Set-SPPassPhrase -PassPhrase $passphrase -Confirm

此示例查询一个字符串以将其用作 passphrase，并将服务器场密码设置为一个新值。