Compartir a través de

New-AzDataFactoryEncryptValue

  • Referencia
Módulo:
Az.DataFactory

Cifra los datos confidenciales.

Sintaxis

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=******' -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 -String '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 "******" -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 "******" -AsPlainText -Force
$Password = ConvertTo-SecureString "******" -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=******;" -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
  • Básico
  • Anónimo.
Tipo:String
Valores aceptados:Windows, Basic, Anonymous
Posición:6
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín: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í.

Tipo:PSCredential
Posición:3
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Database

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

Tipo:String
Posición:8
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-DataFactory

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

Tipo:PSDataFactory
Posición:0
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín: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.

Tipo:String
Posición:1
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-DefaultProfile

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

Tipo:IAzureContextContainer
Alias:AzContext, AzureRmContext, AzureCredential
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín: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.

Tipo:String
Posición:2
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-NonCredentialValue

Especifica la parte que no es de credencial de la cadena de conexión De conectividad abierta de base de datos (ODBC). Este parámetro solo es aplicable para el servicio vinculado ODBC.

Tipo:String
Posición:5
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-ResourceGroupName

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

Tipo:String
Posición:0
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-Server

Especifica el nombre del servidor del servicio vinculado.

Tipo:String
Posición:7
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín: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
Tipo:String
Valores aceptados:OnPremisesSqlLinkedService, OnPremisesFileSystemLinkedService, OnPremisesOracleLinkedService, OnPremisesOdbcLinkedService, OnPremisesPostgreSqlLinkedService, OnPremisesTeradataLinkedService, OnPremisesMySQLLinkedService, OnPremisesDB2LinkedService, OnPremisesSybaseLinkedService, HdfsLinkedService
Posición:4
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín: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.

Tipo:SecureString
Posición:1
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

Entradas

PSDataFactory

String

Salidas

String

Notas

  • Palabras clave: azure, azurerm, arm, resource, management, manager, data, factorys