New-SCSPFTenant

ホストの新しいテナントを作成します。

構文

New-SCSPFTenant
   -Name <String>
   [-Stamps <Stamp[]>]
   [-SubscriptionId <Guid>]
   [-AccountStatus <String>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-SCSPFTenant
   -Name <String>
   -Key <String>
   -IssuerName <String>
   [-Stamps <Stamp[]>]
   [-SubscriptionId <Guid>]
   [-AccountStatus <String>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-SCSPFTenant
   -Name <String>
   -Certificate <String>
   -IssuerName <String>
   [-Stamps <Stamp[]>]
   [-SubscriptionId <Guid>]
   [-AccountStatus <String>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

説明

New-SCSPFTenant コマンドレットは、Service Provider Foundation に新しいテナントを作成します。 サービス プロバイダーの場合、テナントは有料顧客です。 プライベート クラウドで Service Provider Foundation を使用している場合、テナントは組織内のビジネス ユニットです。

例 1: 新しいテナントを作成する

PS C:\>$Path = "C:\Temp\ADatum29D.cer"
PS C:\> $Certificate = New-Object System.Security.Cryptography.X509Certificates.X509Certificate2($Path)
PS C:\> $Key = [Convert]::ToBase64String($Certificate.RawData)
PS C:\> $SubscriptionId = [System.Guid]::NewGuid().ToString()
PS C:\> New-SCSPFTenant -IssuerName "Contoso" -Key $Key -Name "ADatum" -SubscriptionID $SubscriptionId

最初の 2 つのコマンドは、テナントに対して発行された証明書を格納する$Certificate変数を作成します。

3 番目のコマンドは、証明書の公開キーを格納する$Key変数を作成します。

4 番目のコマンドは、サブスクリプションの GUID を格納する$SubscriptionId変数を作成します。

5 番目のコマンドは、証明書の信頼された発行者の名前、公開キー、指定した名前、サブスクリプションに関連付けられている GUID を使用してテナントを作成します。

パラメーター

-AccountStatus

テナントの状態を指定します。 アクティブの場合は 0、中断の場合は 1 を指定します。

Type:System.String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Certificate

テナントの証明書ファイルへのパスを指定します。

Type:System.String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

コマンドレットの実行前に確認を求めるメッセージが表示されます。

Type:System.Management.Automation.SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-IssuerName

テナントの証明書を発行したパーティーの名前を指定します。 このパラメーターは、テナントによって送信されたトークンを確認するためのメタデータです。このパラメーターと信頼できる発行者オブジェクトを混同しないでください。

Type:System.String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Key

要求ベースの認証でテナントによって送信された署名付きトークンを検証する公開キーを指定します。

Type:System.String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Name

テナントに付ける名前を指定します。

Type:System.String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Stamps

新しいテナントに関連付ける 1 つ以上のスタンプ オブジェクトの名前を指定します。 スタンプを取得するには、Get-SCSPFStamp コマンドレットを使用します。

Type:Microsoft.SystemCenter.Foundation.SPFData.Types.Stamp[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SubscriptionId

テナントのサブスクリプションの GUID を指定します。 テナントの作成後にこの値を変更することはできません。

Type:System.Guid
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

コマンドレットの実行時に発生する内容を示します。 このコマンドレットは実行されません。

Type:System.Management.Automation.SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

入力

None

出力

System.Object