New-SCSPFTenant
建立主機器的新租使用者。
Syntax
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>]Description
New-SCSPFTenant Cmdlet 會在 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前兩個命令會建立$Certificate變數，以包含租使用者的發行憑證。
第三個命令會建立$Key變數，以包含憑證的公開金鑰。
第四個命令會建立$SubscriptionId變數，以包含訂用帳戶的 GUID。
第五個命令會使用憑證的受信任簽發者名稱、公開金鑰、指定的名稱和與訂用帳戶相關聯的 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
在執行 Cmdlet 前提示您確認。
| 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
指定要與新租使用者建立關聯的一或多個戳記物件名稱。 若要取得戳記，請使用 Get-SCSPFStamp Cmdlet。
| 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
顯示執行 Cmdlet 後會發生的情況。 Cmdlet 並不會執行。
| 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