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 ultérieure.

Syntax

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 la configure. 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 être en conflit avec les passerelles existantes sur le même locataire.

Type:	String
Aliases:	Name
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-OverwriteExistingGateway

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-RegionKey

Ce paramètre indique la région Azure associée à votre passerelle. Lorsqu’une région 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 Get-DataGatewayRegion de commande

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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