New-AzDataFactoryEncryptValue
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 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
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 las cadenas seguras de nombre de usuario y 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 de PSCredential devuelto en la variable $credential tal 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.
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 open Database Connectivity (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 aceptables para este parámetro son:
- 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 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.
Tipo: | SecureString |
Posición: | 1 |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
Entradas
Salidas
Notas
- Palabras clave: azure, azurerm, arm, resource, management, manager, data, factorys