New-CrmImportProtectionKey

[This topic is pre-release documentation and is subject to change.]

Imports a new protection key.

Syntax

New-CrmImportProtectionKey
   -KeyName <String>
   -KeyType <Int32>
   -Key <Byte[]>
   -KeyPassword <String>
   [-ApiUrl] <Uri>
   [[-Credential] <PSCredential>]
   [-MaxCrmConnectionTimeOutMinutes <Int32>]
   [<CommonParameters>]

Description

The New-CrmImportProtectionKey cmdlet adds a new protection key.

Examples

Example 1

PS C:\> New-CrmImportProtectionKey -ApiUrl $connectionhost -Credential $cred -KeyName $keyName -Key $keyContent -KeyType 0 -KeyPassword $keyPassword

Imports a new protection key.

Parameters

-ApiUrl

URL of the Dataverse root service endpoint. For information about this parameter see Establish your credentials and connection.

Type:Uri
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Credential

User credential for signing in to Dataverse. For information about this parameter see Establish your credentials and connection.

Type:PSCredential
Position:1
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Key

Content of the protection key.

Type:Byte[]
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-KeyName

Name for the protection key.

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

-KeyPassword

Key password for the protection key.

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

-KeyType

Type of the protection key. Possible values are 0 for PFX, or 1 for HSM.

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

-MaxCrmConnectionTimeOutMinutes

Maximum number in minutes to wait before quitting the operation.

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

Inputs

System.Uri

System.Management.Automation.PSCredential System.Int32

Outputs

System.Object