Add-LocalGroupMember

  • リファレンス
モジュール:
Microsoft.PowerShell.LocalAccounts

ローカル グループにメンバーを追加します。

構文

Add-LocalGroupMember
   [-Group] <LocalGroup>
   [-Member] <LocalPrincipal[]>
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Add-LocalGroupMember
   [-Member] <LocalPrincipal[]>
   [-Name] <String>
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Add-LocalGroupMember
   [-Member] <LocalPrincipal[]>
   [-SID] <SecurityIdentifier>
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

説明

このコマンドレットは Add-LocalGroupMember 、ローカル セキュリティ グループにユーザーまたはグループを追加します。 グループに割り当てられているすべての権限とアクセス許可は、そのグループのすべてのメンバーに割り当てられます。

ローカル コンピューターの 管理istrators グループのメンバーには、そのコンピューターに対するフル コントロールアクセス許可があります。 管理istrators グループ内のユーザーの数を制限します。

コンピューターが doメイン に参加している場合は、ユーザー アカウント、コンピューター アカウント、およびグループ アカウントを、その doメイン および信頼された doメイン からローカル グループに追加できます。

Note

コンピューターが do に参加していてメイン do のメンバーと同じ名前のローカル ユーザーを追加しようとするとメイン doメイン メンバーが追加されます。

例

例 1: 管理istrators グループにメンバーを追加する

このコマンドは、ローカル 管理istrators グループに複数のメンバーを追加します。 新しいメンバーには、ローカル ユーザー アカウント、Microsoft アカウント、Microsoft Entra アカウント、doメイン グループが含まれます。 この例では、Outlook.com のアカウントのユーザー名にプレースホルダー値を使用します。

Add-LocalGroupMember -Group "Administrators" -Member "Admin02", "MicrosoftAccount\username@Outlook.com", "AzureAD\DavidChew@contoso.com", "CONTOSO\Domain Admins"

パラメーター

-Confirm

コマンドレットの実行前に確認を求めるメッセージが表示されます。

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Group

このコマンドレットがメンバーを追加するセキュリティ グループを指定します。

Type:Microsoft.PowerShell.Commands.LocalGroup
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Member

このコマンドレットがセキュリティ グループに追加するユーザーまたはグループの配列を指定します。 ユーザーまたはグループは、名前、セキュリティ ID (SID)、または LocalPrincipal オブジェクトで指定できます。

Type:Microsoft.PowerShell.Commands.LocalPrincipal[]
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Name

このコマンドレットがメンバーを追加するセキュリティ グループの名前を指定します。

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-SID

このコマンドレットがメンバーを追加するセキュリティ グループのセキュリティ ID を指定します。

Type:SecurityIdentifier
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

コマンドレットの実行時に発生する内容を示します。 このコマンドレットは実行されません。

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

入力

System.Management.Automation.SecurityAccountsManager.LocalGroup

ローカル プリンシパルをこのコマンドレットにパイプできます。

String

このコマンドレットに文字列をパイプできます。

SecurityIdentifier

SID をこのコマンドレットにパイプできます。

出力

None

このコマンドレットは、出力を返しません。

メモ

Windows PowerShell には、次のエイリアスが Add-LocalGroupMember含まれています。

  • algm

Microsoft.PowerShell.LocalAccounts モジュールは、64 ビット システムの 32 ビット PowerShell では使用できません。

PrincipalSource プロパティは、LocalUser、LocalGroup、および LocalPrincipal オブジェクトのプロパティで、オブジェクトのソースを記述します。 考えられるソースは次のとおりです。

  • ローカル
  • Active Directory
  • Microsoft Entra グループ
  • Microsoft アカウント

PrincipalSource は、Windows 10、Windows Server 2016、およびそれ以降のバージョンの Windows オペレーティング システムでのみサポートされています。 以前のバージョンの場合、プロパティは空白です。