Set-SCRunAsAccount
Modifica as propriedades de uma conta Run As.
Sintaxe
Set-SCRunAsAccount
[-VMMServer <ServerConnection>]
[-Name <String>]
[-Description <String>]
[-Credential <PSCredential>]
[-Owner <String>]
[-UserRole <UserRole>]
[-RunAsAccount] <RunAsAccount>
[-JobGroup <Guid>]
[-NoValidation]
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[<CommonParameters>] Description
O cmdlet Set-SCRunAsAccount modifica as propriedades de uma conta Run As do Virtual Machine Manager (VMM).
Exemplos
Exemplo 1: Alterar o nome de uma conta Run As existente
PS C:\> $RunAsAccount = Get-SCRunAsAccount -Name "RunAsAccount01"
PS C:\> Set-SCRunAsAccount -RunAsAccount $RunAsAccount -Name "New Run As Account Name" -Description "This is an administrator account for accessing Hyper-V hosts."O primeiro comando obtém o objeto de conta Run As chamado RunAsAccount01 e armazena o objeto na variável $RunAsAccount.
O segundo comando altera o nome da conta Run As armazenada no $RunAsAccount para "New Run As Account Name" e adiciona uma descrição para a conta.
Parâmetros
-Credential
Especifica um objeto de credencial ou, para alguns cmdlets, um objeto de conta Run As que contém o nome de usuário e a senha de uma conta que tem permissão para executar essa ação. Ou, no caso de Restart-SCJob , tem permissão para concluir uma tarefa reiniciada.
Para obter mais informações sobre o objeto PSCredential, digite Get-Help Get-Credential.
Para obter mais informações sobre contas Run As, digite Get-Help New-SCRunAsAccount.
| Tipo: | PSCredential |
| Position: | Named |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | True |
| Aceitar carateres universais: | False |
-Description
Especifica uma descrição para a conta Run As.
| Tipo: | String |
| Position: | Named |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-JobGroup
Especifica um identificador para uma série de comandos que serão executados como um conjunto imediatamente antes da execução do comando final que inclui o mesmo identificador de grupo de trabalhos.
| Tipo: | Guid |
| Position: | Named |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-JobVariable
Especifica que o progresso do trabalho é controlado e armazenado na variável nomeada por esse parâmetro.
| Tipo: | String |
| Position: | Named |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-Name
Especifica o nome de um objeto do VMM.
| Tipo: | String |
| Position: | Named |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-NoValidation
Indica que a conta Run As não validará as credenciais de domínio fornecidas.
| Tipo: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-OnBehalfOfUser
Especifica um nome de usuário. Este cmdlet opera em nome do usuário especificado por esse parâmetro.
| Tipo: | String |
| Position: | Named |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-OnBehalfOfUserRole
Especifica uma função de usuário. Para obter uma função de usuário, use o cmdlet Get-SCUserRole. Este cmdlet opera em nome da função de usuário especificada por esse parâmetro.
| Tipo: | UserRole |
| Position: | Named |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-Owner
Especifica o proprietário de um objeto do VMM na forma de uma conta de usuário de domínio válida.
- Exemplo de formato:
-Owner "Contoso\PattiFuller" - Exemplo de formato:
-Owner "PattiFuller@Contoso"
| Tipo: | String |
| Position: | Named |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-PROTipID
Especifica a ID da dica de Otimização de Desempenho e Recursos (dica PRO) que disparou essa ação. Este parâmetro permite auditar dicas PRO.
| Tipo: | Guid |
| Position: | Named |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-RunAsAccount
Especifica uma conta Run As que contém credenciais com permissão para executar essa ação.
| Tipo: | RunAsAccount |
| Position: | 0 |
| Default value: | None |
| Necessário: | True |
| Aceitar entrada de pipeline: | True |
| Aceitar carateres universais: | False |
-RunAsynchronously
Indica que o trabalho é executado de forma assíncrona para que o controle retorne ao shell de comando imediatamente.
| Tipo: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-UserRole
Especifica um objeto de função de usuário.
| Tipo: | UserRole |
| Position: | Named |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-VMMServer
Especifica um objeto de servidor VMM.
| Tipo: | ServerConnection |
| Position: | Named |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | True |
| Aceitar carateres universais: | False |
Saídas
RunAsAccount
Este cmdlet retorna um objeto RunAsAccount.