New-SPUserLicenseMapping
ライセンス マッピング オブジェクトを作成します。
構文
TrustIdentity
New-SPUserLicenseMapping
-Claim <SPClaim>
-License <String>
[-AssignmentCollection <SPAssignmentCollection>]
[-Confirm]
[-WebApplication <SPWebApplicationPipeBind>]
[-WhatIf]
[<CommonParameters>]
ClaimsValues
New-SPUserLicenseMapping
-ClaimType <String>
-License <String>
-OriginalIssuer <String>
-Value <String>
[-AssignmentCollection <SPAssignmentCollection>]
[-Confirm]
[-ValueType <String>]
[-WebApplication <SPWebApplicationPipeBind>]
[-WhatIf]
[<CommonParameters>]
FormsAuth
New-SPUserLicenseMapping
-License <String>
-Role <String>
-RoleProviderName <String>
[-AssignmentCollection <SPAssignmentCollection>]
[-Confirm]
[-WebApplication <SPWebApplicationPipeBind>]
[-WhatIf]
[<CommonParameters>]
WindowsAuth
New-SPUserLicenseMapping
-License <String>
-SecurityGroup <String>
[-AssignmentCollection <SPAssignmentCollection>]
[-Confirm]
[-WebApplication <SPWebApplicationPipeBind>]
[-WhatIf]
[<CommonParameters>]
説明
このコマンドレットには、複数のパラメーター セットが含まれています。 使用できるのは、1 つのパラメーター セットのパラメーターだけであり、異なるパラメーター セットのパラメーターを組み合わせることはできません。 パラメーター セットの使用法に関する詳しい情報については、「コマンドレットのパラメーター セット」を参照してください。
New-SPUserLicenseMapping コマンドレットを使用して、新しいライセンス マッピング オブジェクトを作成します。
このコマンドレットは、 Add-SPUserLicenseMapping コマンドレットを使用する前に最初に使用する必要があります。
New-SPUserLicenseMapping コマンドレットを使用して作成されたオブジェクトはメモリに格納され、SharePoint Server のどのデータベースにも書き込まれません。
オブジェクトが作成されたら、結果を Add-SPUserLicenseMapping コマンドレットにパイプできます。
Windows PowerShell for SharePoint 製品のアクセス許可と最新情報については、「SharePoint Server コマンドレット」のオンライン ドキュメントをご覧ください。
例
例)
$a = New-SPUserLicenseMapping -SecurityGroup EntSecGroup -License Enterprise
$a | Add-SPUserLicenseMapping
この例では、'EntSecGroup' という名前の Active Directory セキュリティで保護されたグループのライセンス マッピング オブジェクトを作成し、結果を Add-SPUserLicenseMapping コマンドレットにパイプします。
パラメーター
-AssignmentCollection
該当: SharePoint Server 2013、SharePoint Server 2016、SharePoint Server 2019
適切な破棄を行うためにオブジェクトを管理します。 SPWeb や SPSite などのオブジェクトの使用によって大量のメモリが使用される場合があるので、Windows PowerShell スクリプトでこれらのオブジェクトを使用するには適切なメモリ管理が必要です。 メモリの解放が必要になった場合は、SPAssignment オブジェクトを使用して、変数へのオブジェクトの割り当てとオブジェクトの破棄を行うことができます。 割り当てコレクションまたは Global パラメーターが使用されていない場合、SPWeb、SPSite、または SPSiteAdministration オブジェクトが使用されていると、オブジェクトは自動的に破棄されます。
Global パラメーターが使用されている場合は、オブジェクトはすべてグローバル ストアに格納されます。
Stop-SPAssignment コマンドを使用してオブジェクトの使用または破棄を直接行わないと、メモリ不足のシナリオになる場合があります。
パラメーターのプロパティ
| 型: | SPAssignmentCollection |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | True |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Claim
該当: SharePoint Server 2013、SharePoint Server 2016、SharePoint Server 2019
ライセンスするクレーム プリンシパルを指定します。 この値は、正規のクレーム プリンシパルであることが必要です。
パラメーターのプロパティ
| 型: | SPClaim |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
TrustIdentity
| 配置: | Named |
| 必須: | True |
| パイプラインからの値: | True |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-ClaimType
該当: SharePoint Server 2013、SharePoint Server 2016、SharePoint Server 2019
クレームの種類を指定します。 この値は、クレームの種類の正規の名前であることが必要です。
パラメーターのプロパティ
| 型: | String |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
ClaimsValues
| 配置: | Named |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Confirm
該当: SharePoint Server 2013、SharePoint Server 2016、SharePoint Server 2019
コマンドを実行する前に確認メッセージを表示します。
詳細については、次のコマンドを入力します。get-help about_commonparameters
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
| Aliases: | cf |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-License
該当: SharePoint Server 2013、SharePoint Server 2016、SharePoint Server 2019
サポートされている SharePoint ユーザー ライセンスの名前を指定します。
SharePoint ファームでサポートされているライセンスの完全な一覧については、 Get-SPUserLicense コマンドレットを参照してください。
パラメーターのプロパティ
| 型: | String |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | True |
| 残りの引数からの値: | False |
-OriginalIssuer
該当: SharePoint Server 2013、SharePoint Server 2016、SharePoint Server 2019
クレームの発行元を指定します。 この値は、発行元の正規の名前であることが必要です。
パラメーターのプロパティ
| 型: | String |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
ClaimsValues
| 配置: | Named |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Role
該当: SharePoint Server 2013、SharePoint Server 2016、SharePoint Server 2019
フォーム ベースのロールの名前を指定します。 この値は、フォーム ベースのロールの正規の名前であることが必要です。
パラメーターのプロパティ
| 型: | String |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
FormsAuth
| 配置: | Named |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-RoleProviderName
該当: SharePoint Server 2013、SharePoint Server 2016、SharePoint Server 2019
ロール プロバイダーの名前を指定します。 この値は、ロール プロバイダーの正規の名前であることが必要です。
パラメーターのプロパティ
| 型: | String |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
FormsAuth
| 配置: | Named |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-SecurityGroup
該当: SharePoint Server 2013、SharePoint Server 2016、SharePoint Server 2019
AD DS セキュリティ グループの名前を指定します。 この値は、Active Directory セキュリティ グループの名前であることが必要です。
パラメーターのプロパティ
| 型: | String |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
WindowsAuth
| 配置: | Named |
| 必須: | True |
| パイプラインからの値: | True |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Value
該当: SharePoint Server 2013、SharePoint Server 2016、SharePoint Server 2019
クレームの値を指定します。 この値は、正規のクレーム値であることが必要です。
パラメーターのプロパティ
| 型: | String |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
ClaimsValues
| 配置: | Named |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-ValueType
該当: SharePoint Server 2013、SharePoint Server 2016、SharePoint Server 2019
クレームの値の種類を指定します。 この値は、クレーム値の種類の正規の名前であることが必要です。
パラメーターのプロパティ
| 型: | String |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
ClaimsValues
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-WebApplication
該当: SharePoint Server 2013、SharePoint Server 2016、SharePoint Server 2019
マッピングを追加する URL、GUID、Web アプリケーションの名前、または Web アプリケーション オブジェクト インスタンスを指定します。 このパラメーターを省略すると、マッピングはファーム全体に適用されます。
この型は、http://<サーバー名> または http://<サーバー名>/sites/sitename という形式の URL、GUID (12345678-90ab-cdef-1234-567890bcdefgh など)、Web アプリケーションの名前 (SharePoint - 80 など)、あるいは Web アプリケーション オブジェクト インスタンスであることが必要です。
パラメーターのプロパティ
| 型: | SPWebApplicationPipeBind |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-WhatIf
該当: SharePoint Server 2013、SharePoint Server 2016、SharePoint Server 2019
コマンドを実行する代わりに、コマンドの実行結果を説明するメッセージを表示します。
詳細については、次のコマンドを入力します。get-help about_commonparameters
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | None |
| ワイルドカードのサポート: | 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」を参照してください。