Add-DataGatewayCluster

Référence

Module:: DataGateway

Crée un cluster de passerelle de données une fois la passerelle installée sur un ordinateur

Remarque : Pour utiliser cette applet de commande, votre version de passerelle doit être 3000.37.35 (avril 2020) ou une version ultérieure.

Syntaxe

Add-DataGatewayCluster
   -RecoveryKey <SecureString>
   -GatewayName <String>
   [-RegionKey <String>]
   [-OverwriteExistingGateway]
   [<CommonParameters>]

Description

Crée un cluster de passerelle de données une fois la passerelle installée sur un ordinateur

Exemples

Exemple 1

PS C:\> Add-DataGatewayCluster -Name "MyNewGateway" -RecoveryKey (Read-Host "Enter Recovery Key" -AsSecureString)

Crée une passerelle nommée « MyNewGateway ».

Exemple 2

PS C:\> ConvertFrom-SecureString -SecureString (Read-Host "Enter Recovery Key" -AsSecureString) | Out-File -FilePath .\encryptedRecoveryKey.txt
PS C:\> $secureRecoveryKey = (cat .\encryptedRecoveryKey.txt | ConvertTo-SecureString)
PS C:\> Add-DataGatewayCluster -RecoveryKey $secureRecoveryKey -Name "MyNewGateway" -RegionKey brazilsouth

Crée une passerelle nommée « MyNewGateway » dans la région Brésil Sud. Vous pouvez stocker en toute sécurité la clé de récupération chiffrée dans un fichier et le transmettre à Add-DataGatewayCluster sans aucune interaction utilisateur.

Exemple 3

PS C:\> ConvertFrom-SecureString -SecureString (Read-Host "Enter Recovery Key" -AsSecureString) | Out-File -FilePath .\encryptedRecoveryKey.txt
PS C:\> $secureRecoveryKey = (cat .\encryptedRecoveryKey.txt | ConvertTo-SecureString)
PS C:\> Add-DataGatewayCluster -RecoveryKey $secureRecoveryKey -Name "MyNewGateway" -RegionKey brazilsouth -OverwriteExistingGateway

Crée une passerelle nommée « MyNewGateway » dans la région Brésil Sud et remplace la configuration de la passerelle existante sur cet ordinateur local et configure la nouvelle. Vous pouvez stocker en toute sécurité la clé de récupération chiffrée dans un fichier et le transmettre à Add-DataGatewayCluster sans aucune interaction utilisateur.

Paramètres

-GatewayName

Il s’agit du nom du cluster de passerelle qui sera créé. Elle ne peut pas entrer en conflit avec les passerelles existantes sur le même locataire.

Type:	String
Alias:	Name
Position:	Named
Valeur par défaut:	None
Obligatoire:	True
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-OverwriteExistingGateway

Lorsque ce paramètre est défini, il remplace la configuration de passerelle existante sur l’ordinateur local et configure une nouvelle. La passerelle remplacée peut toujours être récupérée sur un autre ordinateur.

Type:	SwitchParameter
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-RecoveryKey

La clé de récupération est utilisée par la passerelle pour chiffrer/déchiffrer les informations d’identification locales. Cela est également réécrit pour restaurer la passerelle ou ajouter un nouveau membre au cluster de passerelle.

Type:	SecureString
Position:	Named
Valeur par défaut:	None
Obligatoire:	True
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-RegionKey

Ce paramètre indique la région Azure associée à votre passerelle. Lorsqu’une RegionKey n’est pas fournie, la région Power BI par défaut de votre locataire est utilisée. Pour obtenir la liste des paramètres de région disponibles, exécutez l’applet de commande Get-DataGatewayRegion

Type:	String
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

Entrées

None

Sorties

System.Void

Notes

Cette commande doit être exécutée avec des informations d’identification basées sur l’utilisateur.

Partager via