New-RoleGroup

構文

CrossForest

New-RoleGroup
    [-Name] <String>
    -LinkedDomainController <String>
    -LinkedForeignGroup <UniversalSecurityGroupIdParameter>
    [-LinkedCredential <PSCredential>]
    [-Confirm]
    [-CustomConfigWriteScope <ManagementScopeIdParameter>]
    [-CustomRecipientWriteScope <ManagementScopeIdParameter>]
    [-Description <String>]
    [-DisplayName <String>]
    [-DomainController <Fqdn>]
    [-Force]
    [-ManagedBy <MultiValuedProperty>]
    [-Members <MultiValuedProperty>]
    [-RecipientOrganizationalUnitScope <OrganizationalUnitIdParameter>]
    [-Roles <RoleIdParameter[]>]
    [-SamAccountName <String>]
    [-WellKnownObject <String>]
    [-WhatIf]
    [<CommonParameters>]

Default

New-RoleGroup
    [-Name] <String>
    [-Confirm]
    [-CustomConfigWriteScope <ManagementScopeIdParameter>]
    [-CustomRecipientWriteScope <ManagementScopeIdParameter>]
    [-Description <String>]
    [-DisplayName <String>]
    [-DomainController <Fqdn>]
    [-Force]
    [-Id <Guid>]
    [-ManagedBy <MultiValuedProperty>]
    [-Members <MultiValuedProperty>]
    [-RecipientOrganizationalUnitScope <OrganizationalUnitIdParameter>]
    [-Roles <RoleIdParameter[]>]
    [-SamAccountName <String>]
    [-WhatIf]
    [<CommonParameters>]

説明

例

例 1

New-RoleGroup -Name "Limited Recipient Management" -Roles "Mail Recipients", "Mail Enabled Public Folders" -Members Kim, Martin

例 2

New-RoleGroup -Name "Seattle Limited Recipient Management" -Roles "Mail Recipients", "Mail Enabled Public Folders" -Members John, Carol -CustomRecipientWriteScope "Seattle Recipients"

例 3

New-RoleGroup -Name "Transport Rules Management" -Roles "Transport Rules" -Members "Compliance Group" -ManagedBy Isabel

例 4

$Credentials = Get-Credential

New-RoleGroup -Name "ContosoUsers: Toronto Recipient Admins" -LinkedDomainController dc02.contosousers.contoso.com -LinkedCredential $Credentials -LinkedForeignGroup "Toronto Administrators" -CustomRecipientWriteScope "Toronto Recipients" -Roles "Mail Recipients"

例 5

$RoleGroup = Get-RoleGroup "Recipient Management"

New-RoleGroup "Limited Recipient Management" -Roles $RoleGroup.Roles

例 6

Remove-ManagementRoleAssignment "Distribution Groups-Limited Recipient Management"

パラメーター

-Confirm

適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Online、セキュリティ & コンプライアンス、Exchange Online Protection

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

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

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

パラメーター セット

-CustomConfigWriteScope

適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019

このパラメーターは、オンプレミスの Exchange でのみ使用できます。

CustomConfigWriteScope パラメーターは、この役割グループで作成された管理役割の割り当てに関連付けるための既存の構成ベースの管理スコープを指定します。 管理スコープ名にスペースが含まれている場合、名前を二重引用符 (") で囲んでください。 Get-ManagementScope コマンドレットを使用して、既存の管理スコープの一覧を取得します。

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

パラメーター セット

-CustomRecipientWriteScope

適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Online、Exchange Online Protection

CustomRecipientWriteScope パラメーターは、この役割グループで作成された管理役割の割り当てに関連付けるための既存の受信者ベースの管理スコープを指定します。 管理スコープ名にスペースが含まれている場合、名前を二重引用符 (") で囲んでください。

Get-ManagementScope コマンドレットを使用して、既存の管理スコープの一覧を取得します。

CustomRecipientWriteScope パラメーターを使用する場合、RecipientOrganizationalUnitScope パラメーターは使用できません。

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

パラメーター セット

-Description

適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Online、セキュリティ & コンプライアンス、Exchange Online Protection

Description パラメーターは、Get-RoleGroup コマンドレットを使用して役割グループを表示する場合に表示される説明を指定します。 説明は二重引用符 (") で囲みます。

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

パラメーター セット

-DisplayName

適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Online、セキュリティ & コンプライアンス、Exchange Online Protection

DisplayName パラメーターは、管理グループのフレンドリ名を指定します。 名前にスペースが含まれている場合、名前を二重引用符 (") で囲みます。 このパラメーターの最大長は 256 文字です。

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

パラメーター セット

-DomainController

適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019

このパラメーターは、オンプレミスの Exchange でのみ使用できます。

DomainController パラメーターは、このコマンドレットで Active Directory からのデータの読み取りまたは Active Directory へのデータの書き込みに使用されるドメイン コントローラーを指定します。 ドメイン コントローラーは、完全修飾ドメイン名 (FQDN) で識別します。 たとえば、dc01.contoso.com です。

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

パラメーター セット

-Force

適用対象: Exchange Online、セキュリティ & コンプライアンス、Exchange Online Protection

このパラメーターは、クラウドベースのサービスでのみ使用できます。

[強制] スイッチは、警告メッセージまたは確認メッセージを非表示にします。 このスイッチで値を指定する必要はありません。

管理者の入力を求めることが不適切な場合に、このスイッチを使用してタスクをプログラムによって実行することができます。

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

パラメーター セット

-Id

適用対象: セキュリティ & コンプライアンス

このパラメーターは、Security & Compliance PowerShell でのみ使用できます。

このパラメーターは、Microsoft の内部使用のために予約されています。

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

パラメーター セット

-LinkedCredential

適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019

このパラメーターは、オンプレミスの Exchange でのみ使用できます。

LinkedCredential パラメーターは、LinkedDomainController パラメーターで指定されたドメイン コントローラーへのアクセスに使用されるユーザー名とパスワードを指定します。

このパラメーターの値には、Get-Credential コマンドレットが必要です。 このコマンドを一時停止し、資格情報の入力を求めるメッセージを表示するには、値(Get-Credential)を使用します。 または、このコマンドを実行する前に、資格情報を変数 (たとえば、$cred = Get-Credential) に保存し、このパラメーターに変数名 ($cred) を使用します。 詳細については、Get-Credentialに関するページをご覧ください。

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

パラメーター セット

-LinkedDomainController

適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019

このパラメーターは、オンプレミスの Exchange でのみ使用できます。

LinkedDomainController パラメーターは、外部 USG が存在するフォレスト内のドメイン コントローラーの完全修飾ドメイン名 (FQDN) または IP アドレスを指定します。 指定するドメイン コントローラーは、LinkedForeignGroup パラメーターで指定される外部 USG のセキュリティ情報を取得するために使用されます。

LinkedDomainController パラメーターを使用する場合は、LinkedForeignGroup パラメーターを使用して外部 USG を指定する必要があり、Members パラメーターを使用することはできません。

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

パラメーター セット

-LinkedForeignGroup

適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019

このパラメーターは、オンプレミスの Exchange でのみ使用できます。

LinkedForeignGroup パラメーターは、この役割グループのリンク先とする外部 USG の名前を指定します。 外部 USG 名にスペースが含まれている場合、名前を二重引用符 (") で囲んでください。

LinkedForeignGroup パラメーターを使用する場合は、LinkedDomainController パラメーターでドメイン コントローラーを指定する必要があり、Members パラメーターを使用することはできません。

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

パラメーター セット

-ManagedBy

適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Online、Exchange Online Protection

ManagedBy パラメーターは、役割グループの構成を変更したり、役割グループのメンバーの追加と削除を行ったりすることができるユーザーまたは USG を指定します。

追加するユーザーまたは USG の名前、識別名 (DN)、またはプライマリ SMTP アドレスを使用できます。 ユーザーまたは USG の名前にスペースが含まれている場合、名前を二重引用符 (") で囲んでください。

複数のユーザーまたは USG を追加する場合、コンマで区切ります。

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

パラメーター セット

-Members

適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Online、セキュリティ & コンプライアンス、Exchange Online Protection

Members パラメーターは、役割グループのメンバーとして追加するメールボックスまたはメールが有効な USG を指定します。 ユーザーまたはグループは、名前、DN、またはプライマリ SMTP アドレスの値で識別できます。 複数のメンバーをコンマ (Value1,Value2,...ValueN) で区切って指定できます。 値にスペースが含まれている場合は、値を引用符 ("Value 1","Value 2",..."Value N") で囲みます。

Members パラメーターを使用する場合、LinkedForeignGroup、LinkedDomainController、または LinkedCredential パラメーターを使用することはできません。

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

パラメーター セット

-Name

適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Online、セキュリティ & コンプライアンス、Exchange Online Protection

Name パラメーターは、新しい役割グループの名前を指定します。 名前には、最大で 64 文字まで入力できます。 名前にスペースが含まれている場合、名前を二重引用符 (") で囲みます。

注: リンクされた役割グループを作成する場合は、リンクされた役割グループと関連する外部フォレストをより簡単に関連付けることができるように、役割グループの名前に外部フォレストの名前を含めるようにすることをお勧めします。 特に、複数のフォレストがある場合、このようにすることが重要です。

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

パラメーター セット

-RecipientOrganizationalUnitScope

適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019

このパラメーターは、オンプレミスの Exchange でのみ使用できます。

RecipientOrganizationalUnitScope パラメーターは、役割グループの作成時に作成されたロールの割り当てに追加される組織単位 (OU) スコープを指定します。 RecipientOrganizationalUnitScope パラメーターを使用する場合は、CustomRecipientWriteScope パラメーターを使用できません。 OU を指定するには、以下の構文を使用します。 ___domain/ou.OU 名にスペースが含まれる場合は、ドメインと OU を二重引用符 (") で囲む必要があります。

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

パラメーター セット

-Roles

適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Online、セキュリティ & コンプライアンス、Exchange Online Protection

Roles パラメーターは、役割グループの作成時に割り当てられる管理役割を指定します。 役割名にスペースが含まれている場合、名前を二重引用符 (") で囲んでください。 複数の役割を割り当てる場合は、役割名をコンマで区切ります。

ロール グループに割り当てることができる組み込みの管理ロールの一覧については、「 組み込みの管理ロール」を参照してください。

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

パラメーター セット

-SamAccountName

適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019

このパラメーターは、オンプレミスの Exchange でのみ使用できます。

SamAccountName パラメーター (Windows 2000 より前のユーザー アカウントまたはグループ名とも呼ばれます) は、古いバージョンの Microsoft Windows クライアントおよびサーバー オペレーティング システムと互換性があるオブジェクト識別子を指定します。 値には、文字、数字、スペース、ピリオド (.)、および次の文字を含めることができます:!、#、$、%、^、&、-、_、{、}、~。 最後の文字をピリオドにすることはできません。 Unicode 文字は使用できますが、アクセント付き文字では競合が発生する可能性があります (例: o と ö match)。 最大の長さは 20 文字です。

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

パラメーター セット

-WellKnownObject

適用対象: Exchange Online、Exchange Online Protection

このパラメーターは、クラウドベースのサービスでのみ使用できます。

{{ Fill WellKnownObject Description }}

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

パラメーター セット

-WhatIf

適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Online、セキュリティ & コンプライアンス、Exchange Online Protection

WhatIf スイッチは、セキュリティ/コンプライアンス PowerShell では機能しません。

WhatIf スイッチは、コマンドの操作をシミュレートします。 このスイッチを使用すると、実際にその変更内容を適用せずに、発生する変更を確認できます。 このスイッチで値を指定する必要はありません。

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

パラメーター セット

CommonParameters

入力

Input types

出力

Output types