Add-UnifiedGroupLinks

構文

Default (既定)

Add-UnifiedGroupLinks
    [-Identity] <UnifiedGroupIdParameter>
    -Links <RecipientIdParameter[]>
    -LinkType <LinkType>
    [-Confirm]
    [-WhatIf]
    [<CommonParameters>]

説明

例

例 1

Add-UnifiedGroupLinks -Identity "Legal Department" -LinkType Members -Links chris@contoso.com,michelle@contoso.com

例 2

$users= Get-User -ResultSize unlimited | where {$_.Department -eq "Marketing" -AND $_.RecipientType -eq "UserMailbox"}

Add-UnifiedGroupLinks -Identity Marketing -LinkType members -Links ($users.UserPrincipalName)

パラメーター

-Confirm

適用対象: Exchange Online、オンプレミス メールボックス用の組み込みセキュリティ アドオン

Confirm スイッチは、確認プロンプトを表示するか非表示にするかを指定します。 このスイッチがコマンドレットに与える影響は、コマンドレットが続行する前に確認を必要とするかどうかによって異なります。

• データを破壊するコマンドレット (たとえば、Remove- コマンドレット) には、先に進む前にユーザーにそのコマンドの確認を強制する組み込みの一時停止があります。 これらのコマンドレットでは、正確な構文-Confirm:$falseを使用して、確認プロンプトを省略できます。
• 他のほとんどのコマンドレット (たとえば、New-* や Set-* コマンドレット) には、組み込みの一時停止はありません。 これらのコマンドレットの場合、値を指定せずに Confirm スイッチを指定すると、一時停止が発生し、続行する前にコマンドの確認を強制されます。

パラメーターのプロパティ

パラメーター セット

-Identity

適用対象: Exchange Online、オンプレミス メールボックス用の組み込みセキュリティ アドオン

Identity パラメーターは、変更する Microsoft 365 グループを指定します。 Microsoft 365 グループを一意に識別する任意の値を使用できます。 例:

• 名前
• Alias
• 識別名 (DN)
• 正規 DN
• 電子メール アドレス
• GUID

パラメーターのプロパティ

パラメーター セット

-Links

適用対象: Exchange Online、オンプレミス メールボックス用の組み込みセキュリティ アドオン

Links パラメーターは、Microsoft 365 グループに追加する受信者を指定します。 LinkType パラメーターを使用して、これらの受信者がメンバー、所有者、またはサブスクライバーであるかどうかを指定します。

受信者を一意に識別する任意の値を使用できます。 たとえば、次の値を使用できます。

• 名前
• Alias
• 識別名 (DN)
• 正規 DN
• 電子メール アドレス
• GUID

Update 値にスペースを含める、または引用符を必要とする場合は、次の構文を使用します: "Value1","Value2",..."ValueN"。

このパラメーターは、LinkType パラメーターと共に使用する必要があります。つまり、指定した受信者が Microsoft 365 グループで同じ役割を受け取ることを意味します (同じコマンドで異なる役割の受信者を追加することはできません)。

注: このコマンドレットを使用すると、グループ メンバーのみがグループの所有者になります。 所有者として追加する前に、ユーザーをメンバーとして追加します。 この制限は、グループ所有者として非メンバーを追加できる Web 管理ポータルには適用されません。 ゲスト ユーザーはグループ所有者にはなれません。

パラメーターのプロパティ

パラメーター セット

-LinkType

適用対象: Exchange Online、オンプレミス メールボックス用の組み込みセキュリティ アドオン

LinkType パラメーターは、追加する Microsoft 365 グループ内の受信者の役割を指定します。 有効な値は次のとおりです。

• メンバー: 会話への参加、Teams チャネルの作成、ファイルでの共同作業、接続された SharePoint サイトの編集を行います。
• 所有者: メンバーの追加または削除、会話の削除、チーム設定の変更、チームの削除、接続されている SharePoint サイトのフル コントロール。 グループには、最低 1 人の所有者が必要です。
• サブスクライバー: グループから会話および予定表イベントの通知を受け取る既存のグループ メンバー。 すべてのサブスクライバーはグループのメンバーですが、すべてのメンバーが必ずしもサブスクライバーであるとは限りません (グループの AutoSubscribeNewMembers プロパティの値とメンバーが追加されたタイミングによって異なります)。

このパラメーターは、Links パラメーターと共に使用する必要があります。

注: このコマンドレットを使用すると、グループ メンバーのみがグループの所有者になります。 所有者として追加する前に、ユーザーをメンバーとして追加します。 この制限は、グループ所有者として非メンバーを追加できる Web 管理ポータルには適用されません。 ゲスト ユーザーはグループ所有者にはなれません。

パラメーターのプロパティ

パラメーター セット

-WhatIf

適用対象: Exchange Online、オンプレミス メールボックス用の組み込みセキュリティ アドオン

[WhatIf] スイッチは、何も変更を加えずにコマンドが実行する内容を表示します。 このスイッチで値を指定する必要はありません。

パラメーターのプロパティ

パラメーター セット

CommonParameters