Add-LocalGroupMember
ローカル グループにメンバーを追加します。
構文
Group
Add-LocalGroupMember
[-Group] <LocalGroup>
[-Member] <LocalPrincipal[]>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Default
Add-LocalGroupMember
[-Member] <LocalPrincipal[]>
[-Name] <String>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
SecurityIdentifier
Add-LocalGroupMember
[-Member] <LocalPrincipal[]>
[-SID] <SecurityIdentifier>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
説明
Add-LocalGroupMember コマンドレットは、ローカル セキュリティ グループにユーザーまたはグループを追加します。 グループに割り当てられているすべての権限とアクセス許可は、そのグループのすべてのメンバーに割り当てられます。
ローカル コンピューターの Administrators グループのメンバーには、そのコンピューターに対するフル コントロールのアクセス許可があります。 Administrators グループ内のユーザーの数を制限します。
コンピューターがドメインに参加している場合は、そのドメインと信頼されたドメインのユーザー アカウント、コンピューター アカウント、およびグループ アカウントをローカル グループに追加できます。
注
コンピューターがドメインに参加していて、ドメインのメンバーと同じ名前のローカル ユーザーを追加しようとすると、ドメイン メンバーが追加されます。
例
例 1: Administrators グループにメンバーを追加する
このコマンドは、複数のメンバーをローカルの Administrators グループに追加します。 新しいメンバーには、ローカル ユーザー アカウント、Microsoft アカウント、Microsoft Entra アカウント、ドメイン グループが含まれます。 この例では、Outlook.com のアカウントのユーザー名にプレースホルダー値を使用します。
Add-LocalGroupMember -Group "Administrators" -Member "Admin02", "MicrosoftAccount\username@Outlook.com", "AzureAD\DavidChew@contoso.com", "CONTOSO\Domain Admins"
パラメーター
-Confirm
コマンドレットを実行する前に確認を求めるメッセージが表示されます。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | False |
| ワイルドカードのサポート: | False |
| DontShow: | False |
| Aliases: | cf |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Group
このコマンドレットがメンバーを追加するセキュリティ グループを指定します。
パラメーターのプロパティ
| 型: | Microsoft.PowerShell.Commands.LocalGroup |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
Group
| 配置: | 0 |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Member
このコマンドレットがセキュリティ グループに追加するユーザーまたはグループの配列を指定します。 ユーザーまたはグループは、名前、セキュリティ ID (SID)、または LocalPrincipal オブジェクト 指定できます。
パラメーターのプロパティ
| 型: | Microsoft.PowerShell.Commands.LocalPrincipal[] |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | 1 |
| 必須: | True |
| パイプラインからの値: | True |
| プロパティ名別のパイプラインからの値: | True |
| 残りの引数からの値: | False |
-Name
このコマンドレットがメンバーを追加するセキュリティ グループの名前を指定します。
パラメーターのプロパティ
| 型: | String |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
Default
| 配置: | 0 |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-SID
このコマンドレットがメンバーを追加するセキュリティ グループのセキュリティ ID を指定します。
パラメーターのプロパティ
| 型: | SecurityIdentifier |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
SecurityIdentifier
| 配置: | 0 |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-WhatIf
コマンドレットを実行した場合の動作を示します。 コマンドレットは実行されません。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | False |
| ワイルドカードのサポート: | False |
| DontShow: | False |
| Aliases: | ウィスコンシン |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
CommonParameters
このコマンドレットでは、一般的なパラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable の各パラメーターがサポートされています。 詳細については、about_CommonParametersを参照してください。
入力
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 オペレーティング システムでのみサポートされます。 以前のバージョンの場合、プロパティは空白です。
