Sdílet prostřednictvím

Set-LocalGroup

  • Reference
Modul:
Microsoft.PowerShell.LocalAccounts

Změní místní skupinu zabezpečení.

Syntaxe

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

Rutina Set-LocalGroup změní místní skupinu zabezpečení.

Příklady

Příklad 1: Změna popisu skupiny

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

Tento příkaz změní popis místní skupiny.

Poznámka:

Modul Microsoft.PowerShell.LocalAccounts není k dispozici v 32bitovém PowerShellu v 64bitovém systému.

Parametry

-Confirm

Před spuštěním rutiny zobrazí výzvu k potvrzení.

Typ:SwitchParameter
Aliasy:cf
Position:Named
Default value:False
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Description

Určuje komentář pro skupinu. Maximální délka je 48 znaků.

Typ:String
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-InputObject

Určuje skupinu zabezpečení, kterou tato rutina změní. K získání skupiny zabezpečení použijte rutinu Get-LocalGroup.

Typ:Microsoft.PowerShell.Commands.LocalGroup
Position:0
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-Name

Určuje název skupiny zabezpečení, kterou tato rutina změní.

Typ:String
Position:0
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-SID

Určuje ID zabezpečení (SID) skupiny zabezpečení, kterou tato rutina změní.

Typ:SecurityIdentifier
Position:0
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-WhatIf

Zobrazuje, co by se stalo při spuštění rutiny. Rutina není spuštěna.

Typ:SwitchParameter
Aliasy:wi
Position:Named
Default value:False
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

Vstupy

System.Management.Automation.SecurityAccountsManager.LocalGroup

Do této rutiny můžete převést skupinu zabezpečení.

String

Do této rutiny můžete zamísit řetězec.

SecurityIdentifier

Identifikátor SID můžete do této rutiny převést.

Výstupy

None

Tato rutina nevrátí žádný výstup.

Poznámky

Windows PowerShell obsahuje následující aliasy pro Set-LocalGroup:

  • slg

PrincipalSource vlastnost je vlastnost localUser, LocalGroup a LocalPrincipal objekty, které popisují zdroj objektu. Možné zdroje jsou následující:

  • Místní
  • Active Directory
  • Skupina Microsoft Entra
  • Účet Microsoft

PrincipalSource podporuje jenom Windows 10, Windows Server 2016 a novější verze operačního systému Windows. U starších verzí je tato vlastnost prázdná.