New-SCSPFTenant

New-SCSPFTenant

Creates a new tenant for a hoster.

構文

Parameter Set: Empty
New-SCSPFTenant -Name <String> [-AccountStatus <String> ] [-Offer <Offer> ] [-Stamps <Stamp[]> ] [-SubscriptionId <Guid> ] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: FromTenantCertParameterSetName
New-SCSPFTenant -Certificate <String> -IssuerName <String> -Name <String> [-AccountStatus <String> ] [-Offer <Offer> ] [-Stamps <Stamp[]> ] [-SubscriptionId <Guid> ] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: FromTenantIssuereParameterSetName
New-SCSPFTenant -IssuerName <String> -Key <String> -Name <String> [-AccountStatus <String> ] [-Offer <Offer> ] [-Stamps <Stamp[]> ] [-SubscriptionId <Guid> ] [-Confirm] [-WhatIf] [ <CommonParameters>]

詳細説明

The New-SCSPFTenant cmdlet creates a new tenant in Service Provider Foundation. If you are a service provider, these are your paying customers. If you are using Service Provider Foundation in private cloud, these are the business units of your organization.

パラメーター

-AccountStatus<String>

Sets the status of a tenant. Specify 0 for Active, 1 for Suspended.

-Certificate<String>

Specifies the path to the certificate file for the tenant.

-IssuerName<String>

Specifies the name of the party that issued the certificate for the tenant. This parameter is not to be confused with a trusted issuer object, as it is metadata to verify a token submitted by the tenant.

-Key<String>

Specifies the public key that validates a signed token submitted by a tenant in claims-based authentication.

-Name<String>

Specifies the name to give to the tenant.

-Offer<Offer>

Specifies the name of one or more offer objects to associate with the new tenant. To obtain an offer, use the Get-SCSPFOffer cmdlet.

-Stamps<Stamp[]>

Specifies the name of one or more stamp objects to associate with the new tenant. To obtain a stamp, use the Get-SCSPFStamp cmdlet.

-SubscriptionId<Guid>

Specifies the subscription identifier (as a GUID) for a tenant. This value cannot be changed after the tenant is created.

-Confirm

コマンドレットを実行する前に、ユーザーに確認を求めます。

-WhatIf

コマンドレットを実行するとどのような結果になるかを表示します。コマンドレットは実行されません。

<CommonParameters>

このコマンドレットは次の共通パラメーターをサポートします。-Verbose、-Debug、-ErrorAction、-ErrorVariable、-OutBuffer、-OutVariable.詳細については、以下を参照してください。 about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216)。

入力

入力型は、コマンドレットにパイプできるオブジェクトの型です。

出力

出力型は、コマンドレットによって生成されるオブジェクトの型です。

例

1: Onboard a tenant.

The first two commands create the $cert variable that contains the tenant's issued certificate.

The third command creates the $key variable that contains the certificate's public key.

The fourth command creates the $subID variable that contains a GUID for the subscription ID.

The fifth command creates the tenant with the name of the trusted issuer of the certificate, the public key, a specified name, and the subscription ID.

PS C:\> $path = "C:\Temp\ADatum29D.cer"

PS C:\> $cert = New-Object System.Security.Cryptography.X509Certificates.X509Certificate2($path)

PS C:\> $key = [Convert]::ToBase64String($cert.RawData)

PS C:\> $subID = [System.Guid]::NewGuid().ToString()

PS C:\> New-SCSPFTenant -IssuerName "Woodgrove" -Key $key -Name "ADatum" –SubscriptionID $subID

関連トピック

Remove-SCSPFTenant

Set-SCSPFTenant

Get-SCSPFTenant