New-AzDataFactoryEncryptValue

Referencia

Módulo:: Az.DataFactory

Cifra los datos confidenciales.

Syntax

New-AzDataFactoryEncryptValue
   [-DataFactoryName] <String>
   [[-Value] <SecureString>]
   [-GatewayName] <String>
   [[-Credential] <PSCredential>]
   [[-Type] <String>]
   [[-NonCredentialValue] <String>]
   [[-AuthenticationType] <String>]
   [[-Server] <String>]
   [[-Database] <String>]
   [-ResourceGroupName] <String>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

New-AzDataFactoryEncryptValue
   [-DataFactory] <PSDataFactory>
   [[-Value] <SecureString>]
   [-GatewayName] <String>
   [[-Credential] <PSCredential>]
   [[-Type] <String>]
   [[-NonCredentialValue] <String>]
   [[-AuthenticationType] <String>]
   [[-Server] <String>]
   [[-Database] <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Description

El cmdlet New-AzDataFactoryEncryptValue cifra datos confidenciales, como una contraseña o un cadena de conexión de Microsoft SQL Server, y devuelve un valor cifrado.

Ejemplos

Ejemplo 1: Cifrar una cadena de conexión que no sea ODBC

$Value = ConvertTo-SecureString 'Data Source=ContosoServer;Initial Catalog=catalog;user id =user123;password=password123' -AsPlainText -Force 
New-AzDataFactoryEncryptValue -GatewayName "WikiGateway" -DataFactoryName "WikiAdf" -Value $value -ResourceGroupName "ADF" -Type OnPremisesSqlLinkedService

El primer comando usa el cmdlet ConvertTo-SecureString para convertir el cadena de conexión especificado en un objeto SecureString y, a continuación, almacena ese objeto en la variable $Value. Para obtener más información, escriba Get-Help ConvertTo-SecureString. Valores permitidos: SQL Server o Oracle cadena de conexión. El segundo comando crea un valor cifrado para el objeto almacenado en $Value para la factoría de datos, la puerta de enlace, el grupo de recursos y el tipo de servicio vinculado especificados.

Ejemplo 2: Cifrar un cadena de conexión que no sea ODBC que use autenticación de Windows.

$Value = ConvertTo-SecureString 'Data Source=ContosoServer;Initial Catalog=catalog;Integrated Security=True' -AsPlainText -Force
$Credential = Get-Credential
New-AzDataFactoryEncryptValue -DataFactoryName "WikiADF" -GatewayName "WikiGateway" -ResourceGroupName "ADF" -Value $Value -Credential $Credential -Type OnPremisesSqlLinkedService

El primer comando usa ConvertTo-SecureString para convertir el cadena de conexión especificado en un objeto de cadena seguro y, a continuación, almacena ese objeto en la variable $Value. El segundo comando usa el cmdlet Get-Credential para recopilar la autenticación de Windows (nombre de usuario y contraseña) y, a continuación, almacena ese objeto PSCredential en la variable $Credential. Para obtener más información, escriba Get-Help Get-Credential. El tercer comando crea un valor cifrado para el objeto almacenado en $Value y $Credential para la factoría de datos, la puerta de enlace, el grupo de recursos y el tipo de servicio vinculado especificados.

Ejemplo 3: Cifrado del nombre y las credenciales del servidor para el servicio vinculado del sistema de archivos

$Value = ConvertTo-SecureString '\\servername' -AsPlainText -Force
$Credential = Get-Credential
New-AzDataFactoryEncryptValue -DataFactoryName "WikiADF" -GatewayName "WikiGateway" -ResourceGroupName "ADF" -Value $Value -Credential $Credential -Type OnPremisesFileSystemLinkedService

El primer comando usa ConvertTo-SecureString para convertir la cadena especificada en una cadena segura y, a continuación, almacena ese objeto en la variable $Value. El segundo comando usa Get-Credential para recopilar el autenticación de Windows (nombre de usuario y contraseña) y, a continuación, almacena ese objeto PSCredential en la variable $Credential. El tercer comando crea un valor cifrado para el objeto almacenado en $Value y $Credential para la factoría de datos, la puerta de enlace, el grupo de recursos y el tipo de servicio vinculado especificados.

Ejemplo 4: Cifrado de credenciales para el servicio vinculado de HDFS

$UserName = ConvertTo-SecureString "domain\\username" -AsPlainText -Force
$Password = ConvertTo-SecureString "password" -AsPlainText -Force
$Credential = New-Object System.Management.Automation.PSCredential ($UserName, $Password)
New-AzDataFactoryEncryptValue -DataFactoryName "MyDataFactory" -ResourceGroupName "MyResourceGroup" -GatewayName "MyDataManagementGateway" -Type HdfsLinkedService -AuthenticationType Windows -Credential $Credential -NonCredentialValue "http://server01.com:50070/webhdfs/v1/user/username"

El comando ConvertTo-SecureString convierte la cadena especificada en una cadena segura. El comando New-Object crea un objeto PSCredential mediante el nombre de usuario seguro y las cadenas de contraseña. En su lugar, puede usar el comando Get-Credential para recopilar autenticación de Windows (nombre de usuario y contraseña) y, a continuación, almacenar el objeto PSCredential devuelto en la variable $credential como se muestra en los ejemplos anteriores. El comando New-AzDataFactoryEncryptValue crea un valor cifrado para el objeto almacenado en $Credential para la factoría de datos, la puerta de enlace, el grupo de recursos y el tipo de servicio vinculado especificados.

Ejemplo 5: Cifrado de credenciales para el servicio vinculado ODBC

$Content = ConvertTo-SecureString "UID=username@contoso;PWD=password;" -AsPlainText -Force
New-AzDataFactoryEncryptValue -ResourceGroupName $RGName -DataFactoryName $DFName -GatewayName $Gateway -Type OnPremisesOdbcLinkedService -AuthenticationType Basic -NonCredentialValue "Driver={SQL Server};Server=server01.database.contoso.net; Database=HDISScenarioTest;" -Value $content

El comando ConvertTo-SecureString convierte la cadena especificada en una cadena segura. El comando New-AzDataFactoryEncryptValue crea un valor cifrado para el objeto almacenado en $Value para la factoría de datos, la puerta de enlace, el grupo de recursos y el tipo de servicio vinculado especificados.

Parámetros

-AuthenticationType

Especifica el tipo de autenticación que se va a usar para conectarse al origen de datos. Los valores permitidos para este parámetro son los siguientes:

Windows
Basic
Anónimo.

Type:	String
Accepted values:	Windows, Basic, Anonymous
Position:	6
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Credential

Especifica las credenciales de autenticación de Windows (nombre de usuario y contraseña) que se van a usar. Este cmdlet cifra los datos de credenciales que especifique aquí.

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

-Database

Especifica el nombre de la base de datos del servicio vinculado.

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

-DataFactory

Especifica un objeto PSDataFactory . Este cmdlet cifra los datos de la factoría de datos que especifica este parámetro.

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

-DataFactoryName

Especifica el nombre de una factoría de datos. Este cmdlet cifra los datos de la factoría de datos que especifica este parámetro.

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

-DefaultProfile

Las credenciales, la cuenta, el inquilino y la suscripción que se usan para la comunicación con Azure

Type:	IAzureContextContainer
Aliases:	AzContext, AzureRmContext, AzureCredential
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-GatewayName

Especifica el nombre de la puerta de enlace. Este cmdlet cifra los datos de la puerta de enlace que especifica este parámetro.

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

-NonCredentialValue

Especifica la parte que no es de credencial de la cadena de conexión Open Database Conectar ivity (ODBC). Este parámetro solo es aplicable para el servicio vinculado ODBC.

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

-ResourceGroupName

Especifica el nombre de un grupo de recursos de Azure. Este cmdlet cifra los datos del grupo que especifica este parámetro.

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

-Server

Especifica el nombre del servidor del servicio vinculado.

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

-Type

Especifica el tipo de servicio vinculado. Este cmdlet cifra los datos del tipo de servicio vinculado que especifica este parámetro. Los valores permitidos para este parámetro son los siguientes:

OnPremisesSqlLinkedService
OnPremisesFileSystemLinkedService
OnPremisesOracleLinkedService
OnPremisesOdbcLinkedService
OnPremisesPostgreSqlLinkedService
OnPremisesTeradataLinkedService
OnPremisesMySQLLinkedService
OnPremisesDB2LinkedService
OnPremisesSybaseLinkedService

Type:	String
Accepted values:	OnPremisesSqlLinkedService, OnPremisesFileSystemLinkedService, OnPremisesOracleLinkedService, OnPremisesOdbcLinkedService, OnPremisesPostgreSqlLinkedService, OnPremisesTeradataLinkedService, OnPremisesMySQLLinkedService, OnPremisesDB2LinkedService, OnPremisesSybaseLinkedService, HdfsLinkedService
Position:	4
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Value

Especifica el valor que se va a cifrar. Para un servicio vinculado de SQL Server local y un servicio vinculado de Oracle local, use un cadena de conexión. Para un servicio vinculado ODBC local, use la parte de credencial de la cadena de conexión. En el caso del servicio vinculado del sistema de archivos local, si el sistema de archivos es local en el equipo de puerta de enlace, use Local o localhost y, si el sistema de archivos está en un servidor diferente del equipo de puerta de enlace, use \\servername.

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

Entradas

PSDataFactory

String

Salidas