Add-UnifiedGroupLinks
このコマンドレットは、クラウドベースのサービスでのみ使用できます。
Add-UnifiedGroupLinks コマンドレットを使用して、メンバー、所有者、サブスクライバーをクラウドベースの組織のMicrosoft 365 グループに追加します。 メンバー、所有者、サブスクライバーを削除するには、Remove-UnifiedGroupLinks コマンドレットを使用します。 Microsoft 365 グループの他のプロパティを変更するには、Set-UnifiedGroup コマンドレットを使用します。
注: 証明書ベースの認証 (無人スクリプトの場合は CBA またはアプリ専用認証とも呼ばれます) または Azure マネージド ID を使用して接続する場合、このコマンドレットを使用して Microsoft 365 グループのメンバー、所有者、またはサブスクライバーを変更することはできません。 代わりに、Microsoft Graph を使用することができます。 詳細については、「 グループ リソースの種類」を参照してください。
以下の構文セクションのパラメーター セットの詳細については、「Exchangeのコマンドレット構文」を参照してください。
構文
Add-UnifiedGroupLinks
[-Identity] <UnifiedGroupIdParameter>
-Links <RecipientIdParameter[]>
-LinkType <LinkType>
[-Confirm]
[-WhatIf]
[<CommonParameters>] 説明
Microsoft 365 グループは、Microsoft 365 サービス全体で使用できるグループ オブジェクトです。
このコマンドレットを実行する際には、あらかじめアクセス許可を割り当てる必要があります。 このトピックにはこのコマンドレットのすべてのパラメーターが一覧表示されていますが、自分に割り当てられているアクセス許可に含まれていない一部のパラメーターにはアクセスできません。 コマンドレットを組織内で実行するために必要になるアクセス許可とパラメーターを調べるには、「 Find the permissions required to run any Exchange cmdlet」を参照してください。
注: グループの所有者にできるのはメンバーのみであるため、所有者として追加する前に、まずユーザーをメンバーとして追加する必要があります。 ユーザーがグループのメンバーであっても、ゲスト ユーザーをグループの所有者にすることはできません。
例
例 1
Add-UnifiedGroupLinks -Identity "Legal Department" -LinkType Members -Links chris@contoso.com,michelle@contoso.com次の使用例は、メンバー chris@contoso.com と michelle@contoso.com を、法務部という名前の Microsoft 365 グループに追加します。
例 2
$users= Get-User -ResultSize unlimited | where {$_.Department -eq "Marketing" -AND $_.RecipientType -eq "UserMailbox"}
Add-UnifiedGroupLinks -Identity Marketing -LinkType members -Links ($users.UserPrincipalName)この例では、Microsoft 365 グループに一括メンバーを追加する方法を示します。 Department 属性が "Marketing" であるメールボックスは、Marketing という名前の Microsoft 365 グループに追加されます。
パラメーター
-Confirm
Confirm スイッチは、確認プロンプトを表示するか非表示にするかを指定します。 このスイッチがコマンドレットにどのような影響を与えるかは、先に進む前にコマンドレットで確認が必要となるかどうかで決まります。
- 破壊的なコマンドレット (Remove-* コマンドレットなど) には、続行する前にコマンドの確認を強制する組み込みの一時停止があります。 これらのコマンドレットでは、正確な構文
-Confirm:$falseを使用して、確認プロンプトを省略できます。 - 他のほとんどのコマンドレット (New-* コマンドレットや Set-* コマンドレットなど) には、一時停止が組み込まれています。 これらのコマンドレットの場合、値なしで Confirm スイッチを指定すると、先に進む前に、一時停止してコマンドを確認する必要があります。
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-Identity
Identity パラメーターは、変更する Microsoft 365 グループを指定します。 Microsoft 365 グループを一意に識別する任意の値を使用できます。 例:
- 名前
- Alias
- 識別名 (DN)
- 正規 DN
- 電子メール アドレス
- GUID
| Type: | UnifiedGroupIdParameter |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-Links
Links パラメーターは、Microsoft 365 グループに追加する受信者を指定します。 LinkType パラメーターを使用して、これらの受信者がメンバー、所有者、またはサブスクライバーであるかどうかを指定します。
受信者を一意に識別する任意の値を使用できます。 たとえば、次の値を使用できます。
- 名前
- Alias
- 識別名 (DN)
- 正規 DN
- 電子メール アドレス
- GUID
Update 値にスペースが含まれている場合、または引用符が必要な場合は、次の構文を使用します。 "Value1","Value2",..."ValueN"
このパラメーターは LinkType パラメーターと共に使用する必要があります。つまり、指定した受信者はすべて Microsoft 365 グループで同じロールを受け取ります (同じコマンドで異なるロールを持つ受信者を追加することはできません)。
| Type: | RecipientIdParameter[] |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-LinkType
LinkType パラメーターは、追加する Microsoft 365 グループの受信者の役割を指定します。 有効な値は次のとおりです。
- メンバー: 会話に参加し、Teams チャネルを作成し、ファイルで共同作業を行い、接続された SharePoint サイトを編集します。
- 所有者: メンバーの追加または削除、会話の削除、チーム設定の変更、チームの削除、接続された SharePoint サイトのフル コントロール。 グループには、最低 1 人の所有者が必要です。
- サブスクライバー: グループから会話と予定表のイベント通知を受け取るメンバー。 すべてのサブスクライバーはグループのメンバーですが、すべてのメンバーが必ずしもサブスクライバーであるとは限りません (グループの AutoSubscribeNewMembers プロパティの値とメンバーが追加されたタイミングに応じて異なります)。
PowerShell では、グループに追加する所有者またはサブスクライバーもメンバーである必要があります。
このパラメーターは、LinkType パラメーターと共に使用する必要があります。
| Type: | LinkType |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-WhatIf
WhatIf スイッチは、コマンドの操作をシミュレートします。 このスイッチを使用すると、実際にその変更内容を適用せずに、発生する変更を確認できます。 このスイッチで値を指定する必要はありません。
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
フィードバック
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「https://aka.ms/ContentUserFeedback」を参照してください。
フィードバックの送信と表示