Compartir a través de

New-AzDataFactoryEncryptValue

Módulo:
Az.DataFactory Module

Cifra los datos confidenciales.

Sintaxis

ByFactoryName (valor predeterminado) 

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>]

ByFactoryObject 

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 una cadena de conexión de Microsoft SQL Server, y devuelve un valor cifrado.

Ejemplos

Ejemplo 1: Cifrado de una cadena de conexión que no es 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 la cadena de conexión especificada 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: cadena de conexión de SQL Server o Oracle. 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 una cadena de conexión que no sea ODBC que use la 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 la cadena de conexión especificada en un objeto de cadena segura 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 la 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 la 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 aceptables para este parámetro son:

  • Windows
  • Básico
  • Anónimo.

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Valores aceptados:Windows, Basic, Anonymous
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:6
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes: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í.

Propiedades de parámetro

Tipo:PSCredential
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:3
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Database

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

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:8
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-DataFactory

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

Propiedades de parámetro

Tipo:PSDataFactory
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

ByFactoryObject
Posición:0
Obligatorio:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes: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.

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

ByFactoryName
Posición:1
Obligatorio:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-DefaultProfile

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

Propiedades de parámetro

Tipo:IAzureContextContainer
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:AzContext, AzureRmContext, AzureCredential

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes: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.

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:2
Obligatorio:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-NonCredentialValue

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

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:5
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-ResourceGroupName

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

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

ByFactoryName
Posición:0
Obligatorio:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-Server

Especifica el nombre del servidor del servicio vinculado.

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:7
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes: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 aceptables para este parámetro son:

  • OnPremisesSqlLinkedService
  • OnPremisesFileSystemLinkedService
  • OnPremisesOracleLinkedService
  • OnPremisesOdbcLinkedService
  • OnPremisesPostgreSqlLinkedService
  • OnPremisesTeradataLinkedService
  • OnPremisesMySQLLinkedService
  • OnPremisesDB2LinkedService
  • OnPremisesSybaseLinkedService

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Valores aceptados:OnPremisesSqlLinkedService, OnPremisesFileSystemLinkedService, OnPremisesOracleLinkedService, OnPremisesOdbcLinkedService, OnPremisesPostgreSqlLinkedService, OnPremisesTeradataLinkedService, OnPremisesMySQLLinkedService, OnPremisesDB2LinkedService, OnPremisesSybaseLinkedService, HdfsLinkedService
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:4
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes: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 una 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.

Propiedades de parámetro

Tipo:SecureString
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:1
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

CommonParameters

Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para obtener más información, vea about_CommonParameters.

Entradas

PSDataFactory

String

Salidas

String

Notas

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