Set-SmaVariable
Vytvoří nebo upraví proměnnou v SMA.
Syntax
Set-SmaVariable
-Name <String>
-Value <Object>
[-Description <String>]
[-Encrypted]
[-Force]
-WebServiceEndpoint <String>
[-Port <Int32>]
[-AuthenticationType <String>]
[-Credential <PSCredential>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Rutina Set-SmaVariable vytvoří nebo upraví proměnnou ve službě System Management Automation (SMA). Zadejte název proměnné a hodnoty.
K šifrování proměnné použijte parametr Encrypted . Po vytvoření nelze změnit šifrovaný stav proměnné. Tato rutina selže, pokud použijete parametr Encrypted u existující nešifrované proměnné.
Příklady
Příklad 1: Přiřazení hodnoty proměnné
PS C:\> Set-SmaVariable -Name "Variable01" -Value "String07" -WebServiceEndpoint "https://contoso.com/app01" -Encrypted
Tento příkaz přiřadí hodnotu String07 proměnné s názvem Variable01 pro zadaný koncový bod webové služby. Protože příkaz určuje parametr Encrypted , zašifruje proměnnou.
Parametry
-AuthenticationType
Určuje typ ověřování. Platné hodnoty jsou:
- Basic
- Windows
Výchozí hodnota tohoto parametru je Windows. Pokud používáte základní ověřování, musíte zadat přihlašovací údaje pomocí parametru Credential .
Type: | String |
Accepted values: | Basic, Windows |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Confirm
Před spuštěním rutiny zobrazí výzvu k potvrzení.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Credential
Určuje objekt PSCredential pro připojení k webové službě SMA.
K získání objektu přihlašovacích údajů použijte rutinu Get-Credential.
Další informace zobrazíte zadáním Get-Help Get-Credential
.
Type: | PSCredential |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Description
Poskytuje popis proměnné.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Encrypted
Označuje, že tato rutina zašifruje proměnnou.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Force
Upraví proměnnou bez zobrazení výzvy k potvrzení. Rutina vás vyzve k potvrzení, než bude pokračovat, pokud jako hodnotu parametru Value zadáte secureString. Tato rutina vás také vyzve, pokud hodnota obsahuje objekt s secureString jako pole a nepoužíváte šifrovaný parametr.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Name
Určuje název proměnné.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Port
Určuje číslo portu webové služby SMA.
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Value
Určuje hodnotu proměnné.
Type: | Object |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WebServiceEndpoint
Určuje koncový bod jako adresu URL webové služby SMA. Musíte zahrnout protokol, například http:// nebo https://.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
Zobrazuje, co by se stalo při spuštění rutiny. Rutina není spuštěna.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |