Delen via

Set-LocalGroup

  • Referentie
Module:
Microsoft.PowerShell.LocalAccounts

Hiermee wijzigt u een lokale beveiligingsgroep.

Syntaxis

Set-LocalGroup
   -Description <String>
   [-InputObject] <LocalGroup>
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-LocalGroup
   -Description <String>
   [-Name] <String>
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-LocalGroup
   -Description <String>
   [-SID] <SecurityIdentifier>
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

De Set-LocalGroup cmdlet wijzigt een lokale beveiligingsgroep.

Voorbeelden

Voorbeeld 1: Een groepsbeschrijving wijzigen

Set-LocalGroup -Name "SecurityGroup04" -Description "This is a sample description."

Met deze opdracht wordt de beschrijving van een lokale groep gewijzigd.

Notitie

De module Microsoft.PowerShell.LocalAccounts is niet beschikbaar in 32-bits PowerShell op een 64-bits systeem.

Parameters

-Confirm

Hiermee wordt u gevraagd om bevestiging voordat u de cmdlet uitvoert.

Type:SwitchParameter
Aliassen:cf
Position:Named
Default value:False
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Description

Hiermee geeft u een opmerking voor de groep. De maximale lengte is 48 tekens.

Type:String
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-InputObject

Hiermee geeft u de beveiligingsgroep op die door deze cmdlet wordt gewijzigd. Gebruik de cmdlet Get-LocalGroup om een beveiligingsgroep te verkrijgen.

Type:Microsoft.PowerShell.Commands.LocalGroup
Position:0
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-Name

Hiermee geeft u de naam op van de beveiligingsgroep die door deze cmdlet wordt gewijzigd.

Type:String
Position:0
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-SID

Hiermee geeft u de beveiligings-id (SID) op van de beveiligingsgroep die door deze cmdlet wordt gewijzigd.

Type:SecurityIdentifier
Position:0
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-WhatIf

Hiermee wordt weergegeven wat er zou gebeuren als u de cmdlet uitvoert. De cmdlet wordt niet uitgevoerd.

Type:SwitchParameter
Aliassen:wi
Position:Named
Default value:False
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

Invoerwaarden

System.Management.Automation.SecurityAccountsManager.LocalGroup

U kunt een beveiligingsgroep doorsluisen naar deze cmdlet.

String

U kunt een tekenreeks doorsluisen naar deze cmdlet.

SecurityIdentifier

U kunt een SID doorsluisen naar deze cmdlet.

Uitvoerwaarden

None

Deze cmdlet retourneert geen uitvoer.

Notities

Windows PowerShell bevat de volgende aliassen voor Set-LocalGroup:

  • slg

De eigenschap PrincipalSource is een eigenschap voor LocalUser-, LocalGroup- en LocalPrincipal-objecten die de bron van het object beschrijven. De mogelijke bronnen zijn als volgt:

  • Lokaal
  • Active Directory
  • Microsoft Entra-groep
  • Microsoft-account

PrincipalSource wordt alleen ondersteund door Windows 10, Windows Server 2016 en latere versies van het Windows-besturingssysteem. Voor eerdere versies is de eigenschap leeg.