Set-SmaVariable
Tworzy lub modyfikuje zmienną w programie SMA.
Składnia
Set-SmaVariable
-Name <String>
-Value <Object>
[-Description <String>]
[-Encrypted]
[-Force]
-WebServiceEndpoint <String>
[-Port <Int32>]
[-AuthenticationType <String>]
[-Credential <PSCredential>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Opis
Polecenie cmdlet Set-SmaVariable tworzy lub modyfikuje zmienną w programie System Management Automation (SMA). Określ nazwę zmiennej i wartość.
Aby zaszyfrować zmienną, użyj parametru Encrypted . Nie można zmodyfikować zaszyfrowanego stanu zmiennej po utworzeniu. To polecenie cmdlet zakończy się niepowodzeniem, jeśli użyjesz parametru Encrypted w istniejącej, niezaszyfrowanej zmiennej.
Przykłady
Przykład 1: Przypisywanie wartości do zmiennej
PS C:\> Set-SmaVariable -Name "Variable01" -Value "String07" -WebServiceEndpoint "https://contoso.com/app01" -Encrypted
To polecenie przypisuje wartość String07 do zmiennej o nazwie Variable01 dla określonego punktu końcowego usługi internetowej. Ponieważ polecenie określa szyfrowany parametr, szyfruje zmienną.
Parametry
-AuthenticationType
Określa typ uwierzytelniania. Prawidłowe wartości:
- Podstawowa
- Windows
Wartość domyślna tego parametru to Windows. Jeśli używasz uwierzytelniania podstawowego, musisz podać poświadczenia przy użyciu parametru Credential .
Type: | String |
Accepted values: | Basic, Windows |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Confirm
Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Credential
Określa obiekt PSCredential dla połączenia z usługą internetową SMA.
Aby uzyskać obiekt poświadczeń, użyj polecenia cmdlet Get-Credential.
Aby uzyskać więcej informacji, wpisz polecenie Get-Help Get-Credential
.
Type: | PSCredential |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Description
Zawiera opis zmiennej.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Encrypted
Wskazuje, że to polecenie cmdlet szyfruje zmienną.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Force
Modyfikuje zmienną bez monitowania o potwierdzenie. Polecenie cmdlet wyświetli monit o potwierdzenie przed kontynuowaniem, jeśli podasz parametr SecureString jako wartość parametru Value . To polecenie cmdlet wyświetla również monit, jeśli wartość zawiera obiekt z wartością SecureString jako pole i nie używasz parametru Encrypted .
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Name
Określa nazwę zmiennej.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Port
Określa numer portu usługi sieci Web SMA.
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Value
Określa wartość zmiennej.
Type: | Object |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WebServiceEndpoint
Określa punkt końcowy jako adres URL usługi internetowej SMA. Należy dołączyć protokół, na przykład http:// lub https://.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
Pokazuje, co się stanie po uruchomieniu polecenia cmdlet. Polecenie cmdlet nie zostało uruchomione.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |