Sdílet prostřednictvím


Set-LocalGroup

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

Syntax

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

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 cmdletu vás vyzve k potvrzení.

Vlastnosti parametru

Typ:SwitchParameter
Default value:False
Podporuje zástupné znaky:False
DontShow:False
Aliasy:viz

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-Description

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

Vlastnosti parametru

Typ:String
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:Named
Povinné:True
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-InputObject

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

Vlastnosti parametru

Typ:Microsoft.PowerShell.Commands.LocalGroup
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

InputObject
Position:0
Povinné:True
Hodnota z kanálu:True
Hodnota z kanálu podle názvu vlastnosti:True
Hodnota ze zbývajících argumentů:False

-Name

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

Vlastnosti parametru

Typ:String
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

Default
Position:0
Povinné:True
Hodnota z kanálu:True
Hodnota z kanálu podle názvu vlastnosti:True
Hodnota ze zbývajících argumentů:False

-SID

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

Vlastnosti parametru

Typ:SecurityIdentifier
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

SecurityIdentifier
Position:0
Povinné:True
Hodnota z kanálu:True
Hodnota z kanálu podle názvu vlastnosti:True
Hodnota ze zbývajících argumentů:False

-WhatIf

Ukazuje, co se stane, když se příkaz spustí. Příkazový modul nebyl spuštěn.

Vlastnosti parametru

Typ:SwitchParameter
Default value:False
Podporuje zástupné znaky:False
DontShow:False
Aliasy:Wi

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

CommonParameters

Tato rutina podporuje běžné parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction a -WarningVariable. Další informace najdete v about_CommonParameters.

Vstupy

System.Management.Automation.SecurityAccountsManager.LocalGroup

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

String

Do tohoto příkazletu můžete přesměrovat řetězec.

SecurityIdentifier

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

Výstupy

None

Tento cmdlet nevrátí žádný výstup.

Poznámky

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

  • slg

Vlastnost PrincipalSource je vlastnost objektů LocalUser, LocalGroupa LocalPrincipal, která popisuje zdroj objektu. Možné zdroje jsou následující:

  • Místní
  • služba 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á.