Set-SPManagedAccount
設定受管理的帳戶。
Syntax
Set-SPManagedAccount
[-Identity] <SPManagedAccountPipeBind>
-ConfirmPassword <SecureString>
-NewPassword <SecureString>
[-AssignmentCollection <SPAssignmentCollection>]
[-Confirm]
[-EmailNotification <Int32>]
[-PreExpireDays <Int32>]
[-Schedule <String>]
[-SetNewPassword]
[-WhatIf]
[<CommonParameters>]
Set-SPManagedAccount
[-Identity] <SPManagedAccountPipeBind>
-ExistingPassword <SecureString>
[-AssignmentCollection <SPAssignmentCollection>]
[-Confirm]
[-EmailNotification <Int32>]
[-PreExpireDays <Int32>]
[-Schedule <String>]
[-UseExistingPassword]
[-WhatIf]
[<CommonParameters>]
Set-SPManagedAccount
[-Identity] <SPManagedAccountPipeBind>
-Password <SecureString>
[-AssignmentCollection <SPAssignmentCollection>]
[-Confirm]
[-EmailNotification <Int32>]
[-PreExpireDays <Int32>]
[-Schedule <String>]
[-WhatIf]
[<CommonParameters>]
Set-SPManagedAccount
[-Identity] <SPManagedAccountPipeBind>
[-AssignmentCollection <SPAssignmentCollection>]
[-AutoGeneratePassword]
[-Confirm]
[-EmailNotification <Int32>]
[-PreExpireDays <Int32>]
[-Schedule <String>]
[-WhatIf]
[<CommonParameters>]
Description
此 Cmdlet 包含一個以上的參數集。 您可能只會使用到一個參數集中的參數,而且您無法合併不同參數集中的參數。 如需如何使用參數集的詳細資訊,請參閱 Cmdlet 參數集。
Cmdlet Set-SPManagedAccount
會在指定的受管理帳戶上設定屬性。
您可使用此 cmdlet 變更受管理帳戶的密碼到期及通知設定:使用預設的參數集。 此外,也可使用此 cmdlet,將受管理帳戶的密碼變更為按設定排程自動產生的密碼:使用包含 AutoGeneratePassword 參數的參數集。 您還可以使用此 cmdlet,將受管理帳戶的密碼變更為管理員已知的新值:使用包含 SetNewPassword 參數的參數集。 最後,您可使用此 cmdlet,將受管理帳戶的密碼變更為已在 Active Directory 網域服務 (AD DS) 中變更過之現有的值:使用包含 UseExistingPassword 參數的參數集。
如需適用於 SharePoint 產品的 Windows PowerShell 權限及最新資訊,請參閱線上文件 SharePoint Server Cmdlet。
範例
------------------範例-----------------------
$m = Get-SPManagedAccount -Identity "DOMAINx\UserY"
Set-SPManagedAccount -Identity $m -AutoGeneratePassword true
此範例會顯示明確的受控帳戶,如果存在,然後嘗試更新它以使用自動產生的密碼。
參數
-AssignmentCollection
管理物件以適當處置它們。 使用 SPWeb 或 SPSite 等物件可能會耗用大量的記憶體,因此在 Windows PowerShell 指令碼中使用這些物件時,必須適當地管理記憶體。 您可以使用 SPAssignment 物件將物件指派給變數,並在不需要時處置這些物件,以釋放記憶體。 使用 SPWeb、SPSite 或 SPSiteAdministration 物件時,若未使用指派集合或 Global 參數,將會自動處置這些物件。
使用 Global 參數時,所有物件會包含在全域儲存區內。
如果不立即使用物件,或使用 Stop-SPAssignment
命令加以捨棄,則可能會有記憶體不足的狀況發生。
Type: | SPAssignmentCollection |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Applies to: | SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-AutoGeneratePassword
自動產生新密碼。
此類型必須是下列其中一個值:
- True
- False
預設值為 False。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-Confirm
在執行命令之前,提示您確認操作。
如需詳細資訊,請輸入下列命令:get-help about_commonparameters
。
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-ConfirmPassword
確認此受管理帳戶的新密碼。
Type: | SecureString |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-EmailNotification
指定在密碼變更前,提前發送電子郵件通知的天數。
預設值為 5。
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-ExistingPassword
將此受管理帳戶的密碼設為已在 Active Directory 網域服務 (AD DS) 中變更過之現有的值。
Type: | SecureString |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-Identity
指定要擷取之受管理帳戶的完整名稱或局部名稱。
此類型必須是格式為 Domain\User 的有效帳戶名稱,或格式為 1234-3456-09876 的 GUID。
Type: | SPManagedAccountPipeBind |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Applies to: | SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-NewPassword
設定受管理帳戶的新密碼
Type: | SecureString |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-Password
設定受管理帳戶的密碼。
Type: | SecureString |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-PreExpireDays
指定在密碼到期前,提前排程密碼變更的天數。
預設值為 2。
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-Schedule
指定要執行密碼變更工作的新排程。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-SetNewPassword
將密碼設為傳入的新值,並變更 AD DS 中的值。
此類型必須是下列其中一個值:
- True
- False
預設值為 False。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-UseExistingPassword
將密碼設為已在 AD DS 中變更過之傳入的新值。
此類型必須是下列其中一個值:
- True
- False
預設值為 False。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-WhatIf
顯示訊息會描述命令的功效而不執行命令。
如需詳細資訊,請輸入下列命令:get-help about_commonparameters
。
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |