Partager via

New-AzDataFactoryEncryptValue

Module:
Az.DataFactory Module

Chiffre les données sensibles.

Syntaxe

ByFactoryName (Par défaut) 

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

L’applet de commande New-AzDataFactoryEncryptValue chiffre les données sensibles, telles qu’un mot de passe ou une chaîne de connexion Microsoft SQL Server, et retourne une valeur chiffrée.

Exemples

Exemple 1 : Chiffrer une chaîne de connexion non 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

La première commande utilise l’applet de commande ConvertTo-SecureString pour convertir la chaîne de connexion spécifiée en objet SecureString , puis stocke cet objet dans la variable $Value. Pour plus d’informations, tapez Get-Help ConvertTo-SecureString. Valeurs autorisées : SQL Server ou chaîne de connexion Oracle. La deuxième commande crée une valeur chiffrée pour l’objet stocké dans $Value pour la fabrique de données, la passerelle, le groupe de ressources et le type de service lié spécifiés.

Exemple 2 : Chiffrer une chaîne de connexion non ODBC qui utilise l’authentification 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

La première commande utilise ConvertTo-SecureString pour convertir la chaîne de connexion spécifiée en objet de chaîne sécurisée, puis stocke cet objet dans la variable $Value. La deuxième commande utilise l’applet de commande Get-Credential pour collecter l’authentification Windows (nom d’utilisateur et mot de passe), puis stocke cet objet PSCredential dans la variable $Credential. Pour plus d’informations, tapez Get-Help Get-Credential. La troisième commande crée une valeur chiffrée pour l’objet stocké dans $Value et $Credential pour la fabrique de données, la passerelle, le groupe de ressources et le type de service lié spécifiés.

Exemple 3 : Chiffrer le nom du serveur et les informations d’identification pour le service lié au système de fichiers

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

La première commande utilise ConvertTo-SecureString pour convertir la chaîne spécifiée en chaîne sécurisée, puis stocke cet objet dans la variable $Value. La deuxième commande utilise Get-Credential pour collecter l’authentification Windows (nom d’utilisateur et mot de passe), puis stocke cet objet PSCredential dans la variable $Credential. La troisième commande crée une valeur chiffrée pour l’objet stocké dans $Value et $Credential pour la fabrique de données, la passerelle, le groupe de ressources et le type de service lié spécifiés.

Exemple 4 : Chiffrer les informations d’identification pour le service lié 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"

La commande ConvertTo-SecureString convertit la chaîne spécifiée en chaîne sécurisée. La commande New-Object crée un objet PSCredential à l’aide des chaînes de nom d’utilisateur et de mot de passe sécurisées. Au lieu de cela, vous pouvez utiliser la commande Get-Credential pour collecter l’authentification Windows (nom d’utilisateur et mot de passe), puis stocker l’objet PSCredential retourné dans la variable $credential, comme indiqué dans les exemples précédents. La commande New-AzDataFactoryEncryptValue crée une valeur chiffrée pour l’objet stocké dans $Credential pour la fabrique de données, la passerelle, le groupe de ressources et le type de service lié spécifiés.

Exemple 5 : Chiffrer les informations d’identification pour le service lié 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

La commande ConvertTo-SecureString convertit la chaîne spécifiée en chaîne sécurisée. La commande New-AzDataFactoryEncryptValue crée une valeur chiffrée pour l’objet stocké dans $Value pour la fabrique de données, la passerelle, le groupe de ressources et le type de service lié spécifiés.

Paramètres

-AuthenticationType

Spécifie le type d’authentification à utiliser pour se connecter à la source de données. Les valeurs acceptables pour ce paramètre sont les suivantes :

  • Fenêtres
  • Élémentaire
  • Anonyme.

Propriétés du paramètre

Type:String
Valeur par défaut:None
Valeurs acceptées:Windows, Basic, Anonymous
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:6
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-Credential

Spécifie les informations d’identification d’authentification Windows (nom d’utilisateur et mot de passe) à utiliser. Cette applet de commande chiffre les données d’informations d’identification que vous spécifiez ici.

Propriétés du paramètre

Type:PSCredential
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:3
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-Database

Spécifie le nom de la base de données du service lié.

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:8
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-DataFactory

Spécifie un objet PSDataFactory . Cette applet de commande chiffre les données de la fabrique de données spécifiée par ce paramètre.

Propriétés du paramètre

Type:PSDataFactory
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

ByFactoryObject
Position:0
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-DataFactoryName

Spécifie le nom d’une fabrique de données. Cette applet de commande chiffre les données de la fabrique de données spécifiée par ce paramètre.

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

ByFactoryName
Position:1
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-DefaultProfile

Informations d’identification, compte, locataire et abonnement utilisés pour la communication avec Azure

Propriétés du paramètre

Type:IAzureContextContainer
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False
Alias:AzContext, AzureRmContext, AzureCredential

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-GatewayName

Spécifie le nom de la passerelle. Cette applet de commande chiffre les données de la passerelle spécifiée par ce paramètre.

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:2
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-NonCredentialValue

Spécifie la partie non d’informations d’identification de la chaîne de connexion ODBC (Open Database Connectivity). Ce paramètre s’applique uniquement au service lié ODBC.

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:5
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-ResourceGroupName

Spécifie le nom d’un groupe de ressources Azure. Cette applet de commande chiffre les données du groupe spécifié par ce paramètre.

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

ByFactoryName
Position:0
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-Server

Spécifie le nom du serveur du service lié.

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:7
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-Type

Spécifie le type de service lié. Cette applet de commande chiffre les données du type de service lié spécifié par ce paramètre. Les valeurs acceptables pour ce paramètre sont les suivantes :

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

Propriétés du paramètre

Type:String
Valeur par défaut:None
Valeurs acceptées:OnPremisesSqlLinkedService, OnPremisesFileSystemLinkedService, OnPremisesOracleLinkedService, OnPremisesOdbcLinkedService, OnPremisesPostgreSqlLinkedService, OnPremisesTeradataLinkedService, OnPremisesMySQLLinkedService, OnPremisesDB2LinkedService, OnPremisesSybaseLinkedService, HdfsLinkedService
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:4
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-Value

Spécifie la valeur à chiffrer. Pour un service lié SQL Server local et un service lié Oracle local, utilisez une chaîne de connexion. Pour un service lié ODBC local, utilisez la partie d’informations d’identification de la chaîne de connexion. Pour le service lié au système de fichiers local, si le système de fichiers est local sur l’ordinateur de passerelle, utilisez Local ou localhost, et si le système de fichiers se trouve sur un serveur différent de l’ordinateur de passerelle, utilisez \\servername.

Propriétés du paramètre

Type:SecureString
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:1
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

CommonParameters

Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.

Entrées

PSDataFactory

String

Sorties

String

Notes

  • Mots clés : azure, azurerm, arm, resource, management, manager, data, fabriques