Set-SPManagedAccount
Configura a conta gerenciada.
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
Este cmdlet contém mais de um parâmetro definido. Você pode usar apenas parâmetros de um conjunto de parâmetro e você não pode combinar parâmetros de diferentes conjuntos de parâmetros. Para obter mais informações sobre como usar conjuntos de parâmetros, confira Conjuntos de parâmetros de Cmdlets.
O Set-SPManagedAccount cmdlet define as propriedades na conta gerenciada determinada.
É possível usar este cmdlet para alterar as configurações de notificação e de expiração de senha da conta gerenciada: use o conjunto de parâmetros padrão. Além disso, é possível usar este cmdlet para alterar a senha da conta gerenciada para gerar senhas automaticamente de acordo com um cronograma definido: use o conjunto de parâmetros que inclui o parâmetro AutoGeneratePassword. Também é possível usar este cmdlet para alterar a senha da conta gerenciada para um novo valor de conhecimento do administrador: use o conjunto de parâmetros que inclui o parâmetro SetNewPassword. Por fim, você pode usar este cmdlet para alterar a senha da conta gerenciada para um valor existente que tenha sido alterado no AD DS (Serviços de Domínio Active Directory): use o conjunto de parâmetros que inclui o parâmetro UseExistingPassword.
Para obter as permissões e informações mais recentes sobre o Windows PowerShell para Produtos SharePoint, confira a documentação online em Cmdlets do SharePoint Server.
Exemplos
------------------EXEMPLO-----------------------
$m = Get-SPManagedAccount -Identity "DOMAINx\UserY"
Set-SPManagedAccount -Identity $m -AutoGeneratePassword trueEste exemplo exibe uma conta gerenciada explícita se ela existir e, em seguida, tenta atualizá-la para usar senhas geradas automaticamente.
Parâmetros
-AssignmentCollection
Gerencia objetos para o devido descarte. O uso de objetos como SPWeb ou SPSite pode consumir grandes quantidades de memória e o uso desses objetos em scripts do Windows PowerShell requer gerenciamento de memória adequado. Usando o objeto SPAssignment, você poderá atribuir objetos a uma variável e descartar os objetos após o uso para liberar memória. Quando objetos SPWeb, SPSite ou SPSiteAdministration são usados, os objetos são automaticamente descartados se um conjunto de atribuições ou o parâmetro Global não forem usados.
Quando o parâmetro Global é usado, todos os objetos estão contidos no repositório global.
Quando os objetos não são usados imediatamente ou são descartados com o uso do comando Stop-SPAssignment, pode ocorrer um cenário de memória insuficiente.
| 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
Gera uma nova senha automaticamente.
O tipo deve ser um dos valores a seguir:
- Verdadeiro
- Falso
O valor padrão é 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
Solicita sua confirmação antes de executar o comando.
Para saber mais, digite o seguinte comando: 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
Confirma a nova senha da conta gerenciada.
| 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
Especifica o número de dias até a alteração da senha para iniciar as notificações por email.
O valor padrão é 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
Define a senha desta conta gerenciada para um valor existente que já tenha sido alterado no 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
Especifica o nome completo ou parcial das contas gerenciadas a serem recuperadas.
O tipo deve ser um nome de conta válido, no formato Domain\User, ou um GUID, no formato 1234-3456-09876.
| 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
Define uma nova senha para a conta gerenciada
| 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
Define uma senha para a conta gerenciada.
| 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
Especifica o número de dias até a expiração para agendar a alteração da senha.
O valor padrão é 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
Especifica o novo cronograma de execução do trabalho de alteração de senha.
| 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
Define o novo valor da senha e altera o valor no AD DS.
O tipo deve ser um dos valores a seguir:
- Verdadeiro
- Falso
O valor padrão é 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
Define o novo valor da senha que já tenha sido alterado no AD DS.
O tipo deve ser um dos valores a seguir:
- Verdadeiro
- Falso
O valor padrão é 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
Exibe uma mensagem que descreve o efeito do comando em vez de executar o comando.
Para saber mais, digite o seguinte comando: 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 |