Set-SmaCredential
在 SMA 中建立或更新認證。
Syntax
Set-SmaCredential
-Name <String>
-Value <PSCredential>
[-Description <String>]
-WebServiceEndpoint <String>
[-Port <Int32>]
[-AuthenticationType <String>]
[-Credential <PSCredential>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Set-SmaCredential Cmdlet 會在 Service Management Automation (SMA) 中,建立或更新認證作為 PSCredential物件。
範例
範例 1:建立認證
PS C:\> $Creds = Get-Credential
PS C:\> Set-SmaCredential -WebServiceEndpoint "https://contoso.com/app01" -Name "MyCredential" -Value $Creds
第一個命令會使用 Get-Credential Cmdlet 來建立認證物件,然後將物件儲存在$Creds變數中。
第二個命令會使用儲存在 $Creds 中的認證來建立名為 MyCredential 的認證。
參數
-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 |
-Port
指定 SMA Web 服務的埠號碼。
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Value
指定 PSCredential 物件。
Type: | PSCredential |
Position: | Named |
Default value: | None |
Required: | True |
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 |