Set-SmaCertificate
在 SMA 中建立或更新憑證。
Syntax
Set-SmaCertificate
-Name <String>
-Path <String>
-Password <SecureString>
[-Description <String>]
-WebServiceEndpoint <String>
[-Port <Int32>]
[-AuthenticationType <String>]
[-Credential <PSCredential>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Set-SmaCertificate Cmdlet 會在 Service Management Automation (SMA) 中建立或更新憑證。
範例
範例 1:建立憑證
PS C:\> $Password = ConvertTo-SecureString "PassWord!" -AsPlainText -Force
PS C:\> Set-SmaCertificate -WebServiceEndpoint "https://contoso.com/app01" -Name "MyCertificate" -Path "./cert.pfx" -Password $Password
第一個命令會為提供的密碼建立安全字串,並將安全字串儲存在 $Password 變數中。
第二個命令會建立名為 MyCertificate 的憑證。 命令會提供憑證檔案的路徑,以及儲存在 $Password 中的密碼。
參數
-AuthenticationType
指定驗證類型。 有效值為:
- 基本
- Windows
此參數的預設值為 Windows。 如果您使用基本驗證,則必須使用 Credential 參數來提供 認證 。
Type: | String |
Accepted values: | Basic, Windows |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Confirm
在執行 Cmdlet 前提示您確認。
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Credential
指定 SMA Web 服務連線的 PSCredential 物件。
若要取得認證物件,請使用 Get-Credential Cmdlet。
如需詳細資訊,請鍵入 Get-Help Get-Credential
。
Type: | PSCredential |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Description
提供憑證的描述。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Name
指定憑證的名稱。
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Password
將密碼指定為安全字串,以存取憑證。
Type: | SecureString |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Path
指定憑證的本機路徑。
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Port
指定 SMA Web 服務的埠號碼。
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WebServiceEndpoint
指定 SMA Web 服務的端點作為 URL。 例如,您必須包含通訊協定,HTTP:// 或 HTTPs://。
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
顯示執行 Cmdlet 後會發生的情況。 Cmdlet 並不會執行。
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |