Rename-LocalGroup
Renomeia um grupo de segurança local.
Sintaxe
InputObject
Rename-LocalGroup
[-InputObject] <LocalGroup>
[-NewName] <String>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Default
Rename-LocalGroup
[-Name] <String>
[-NewName] <String>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
SecurityIdentifier
Rename-LocalGroup
[-NewName] <String>
[-SID] <SecurityIdentifier>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
O cmdlet Rename-LocalGroup renomeia um grupo de segurança local.
Observação
O módulo Microsoft.PowerShell.LocalAccounts não está disponível no PowerShell de 32 bits em um sistema de 64 bits.
Exemplos
Exemplo 1: alterar o nome de um grupo
PS C:\> Rename-LocalGroup -Name "SecurityGroup" -NewName "SecurityGroup04"
Esse comando renomeia um grupo de segurança chamado SecurityGroup.
Parâmetros
-Confirm
Solicita sua confirmação antes de executar o cmdlet.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | False |
| Dá suporte a curingas: | False |
| DontShow: | False |
| Aliases: | cf |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-InputObject
Especifica o grupo de segurança que esse cmdlet renomeia. Para obter um grupo de segurança, use o cmdlet Get-LocalGroup.
Propriedades do parâmetro
| Tipo: | Microsoft.PowerShell.Commands.LocalGroup |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
InputObject
| Cargo: | 0 |
| Obrigatório: | True |
| Valor do pipeline: | True |
| Valor do pipeline pelo nome da propriedade: | True |
| Valor dos argumentos restantes: | False |
-Name
Especifica o nome do grupo de segurança que esse cmdlet renomeia.
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
Default
| Cargo: | 0 |
| Obrigatório: | True |
| Valor do pipeline: | True |
| Valor do pipeline pelo nome da propriedade: | True |
| Valor dos argumentos restantes: | False |
-NewName
Especifica um novo nome para o grupo de segurança.
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | 1 |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-SID
Especifica a SID (ID de segurança) de um grupo de segurança que esse cmdlet renomeia.
Propriedades do parâmetro
| Tipo: | SecurityIdentifier |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
SecurityIdentifier
| Cargo: | 0 |
| Obrigatório: | True |
| Valor do pipeline: | True |
| Valor do pipeline pelo nome da propriedade: | True |
| Valor dos argumentos restantes: | False |
-WhatIf
Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | False |
| Dá suporte a curingas: | False |
| DontShow: | False |
| Aliases: | wi |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
CommonParameters
Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.
Entradas
System.Management.Automation.SecurityAccountsManager.LocalGroup
Você pode canalizar um grupo de segurança para este cmdlet.
String
Você pode encaminhar uma cadeia de caracteres para este cmdlet.
SecurityIdentifier
Você pode canalizar um SID para este cmdlet.
Saídas
None
Esse cmdlet não retorna nenhuma saída.
Observações
O Windows PowerShell inclui os seguintes aliases para Rename-LocalGroup:
rnlg
A propriedade PrincipalSource é uma propriedade nos objetos LocalUser, LocalGroupe LocalPrincipal que descreve a origem do objeto. As fontes possíveis são as seguintes:
- Local
- Active Directory
- Grupo do Microsoft Entra
- Conta da Microsoft
PrincipalSource tem suporte apenas pelo Windows 10, Windows Server 2016 e versões posteriores do sistema operacional Windows. Em versões anteriores, a propriedade está em branco.
