Set-LocalGroup
Altera um grupo de segurança local.
Sintaxe
InputObject
Set-LocalGroup
[-InputObject] <LocalGroup>
-Description <String>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Default
Set-LocalGroup
[-Name] <String>
-Description <String>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
SecurityIdentifier
Set-LocalGroup
[-SID] <SecurityIdentifier>
-Description <String>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
O cmdlet Set-LocalGroup altera um grupo de segurança local.
Exemplos
Exemplo 1: Alterar uma descrição de grupo
Set-LocalGroup -Name "SecurityGroup04" -Description "This is a sample description."
Este comando altera a descrição de um grupo 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.
Parâmetros
-Confirm
Solicita confirmação antes de executar o cmdlet.
Propriedades dos parâmetros
| Tipo: | SwitchParameter |
| Default value: | False |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
| Aliases: | Cf. |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-Description
Indica um comentário para o grupo. O comprimento máximo é de 48 caracteres.
Propriedades dos parâmetros
| Tipo: | String |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-InputObject
Especifica o grupo de segurança que esse cmdlet altera. Para obter um grupo de segurança, use o cmdlet Get-LocalGroup.
Propriedades dos parâmetros
| Tipo: | Microsoft.PowerShell.Commands.LocalGroup |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
InputObject
| Position: | 0 |
| Obrigatório: | True |
| Valor do pipeline: | True |
| Valor do pipeline por nome de propriedade: | True |
| Valor dos restantes argumentos: | False |
-Name
Especifica o nome do grupo de segurança que esse cmdlet altera.
Propriedades dos parâmetros
| Tipo: | String |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
Default
| Position: | 0 |
| Obrigatório: | True |
| Valor do pipeline: | True |
| Valor do pipeline por nome de propriedade: | True |
| Valor dos restantes argumentos: | False |
-SID
Especifica a ID de segurança (SID) do grupo de segurança que esse cmdlet altera.
Propriedades dos parâmetros
| Tipo: | SecurityIdentifier |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
SecurityIdentifier
| Position: | 0 |
| Obrigatório: | True |
| Valor do pipeline: | True |
| Valor do pipeline por nome de propriedade: | True |
| Valor dos restantes argumentos: | False |
-WhatIf
Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.
Propriedades dos parâmetros
| Tipo: | SwitchParameter |
| Default value: | False |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
| Aliases: | Wi |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | 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 esse cmdlet.
String
Você pode canalizar uma cadeia de caracteres para este cmdlet.
SecurityIdentifier
Você pode canalizar um SID para este cmdlet.
Saídas
None
Este cmdlet não retorna nenhuma saída.
Notas
O Windows PowerShell inclui os seguintes aliases para Set-LocalGroup:
slg
A propriedade PrincipalSource é uma propriedade nos objetos LocalUser, LocalGroupe LocalPrincipal que descreve a origem do objeto. As fontes possíveis são as seguintes:
- Locais
- Active Directory
- Grupo Microsoft Entra
- Conta Microsoft
PrincipalSource é suportado apenas pelo Windows 10, Windows Server 2016 e versões posteriores do sistema operacional Windows. Para versões anteriores, a propriedade está em branco.
