Converts a SecureString object into encrypted text with a FIPS compliant algorithm using a pre-shared key. The Pre-Shared key can be provided as either a 32 byte array or a SecureString value.

ConvertFrom-FIPSSecureString [-SecureString] <SecureString> -SecureKey <SecureString> [<CommonParameters>]

ConvertFrom-FIPSSecureString [-SecureString] <SecureString> -Key <Byte[]> [<CommonParameters>]

{{Fill in the Description}}

ConvertFrom-FIPSSecureString -SecureString $MySecretValue -SecureKey  ( ConvertTo-SecureString -String 'Pr3$haredK3y' -AsPlainText -Force ) | Out-File ./encryptedText.txt

Encrypts a SecureString object and saves it to disk.

The SecureString object that will returned as an encrypted string.

Type: SecureString
Parameter Sets: (All)
Aliases:

Required: True
Position: 2
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False

An array of 32 bytes that will be used as a the pre-shared key for encryption.

Type: Byte[]
Parameter Sets: KeyByte
Aliases:

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

A SecureString that will be converted into a 32 byte array used as the pre-shared key for encryption.

Type: SecureString
Parameter Sets: SecureKey
Aliases:

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters (http://go.microsoft.com/fwlink/?LinkID=113216).