Nota: La integración con PowerShell requiere una suscripción Pro o Enterprise de ShareGate Migrate. No está disponible en el plan Essentials.
Usa PowerShell para generar un archivo de asignación de usuarios de ShareGate Migrate (SGUM) a partir de un archivo CSV.
Puedes usar el archivo SGUM en la aplicación Migrate o en un script de PowerShell.
Nota: La aplicación asigna automáticamente tus usuarios. ShareGate Migrate asignará cualquier usuario que no agregues a tu archivo de asignación.
Requisitos previos
Acceso a la información de tus usuarios o a tu Active Directory/Microsoft Entra ID.
Crea tu CSV
Puedes crear el archivo CSV manualmente o sacar una lista de usuarios desde tu Active Directory. Necesitarás un archivo CSV final con dos columnas: SourceValue y DestinationValue. Puedes usar correo electrónico, nombre de usuario, nombre para mostrar o nombre completo.
El archivo debería verse así en Excel:
Consejo: Recomendamos usar direcciones de correo electrónico, ya que suelen ser únicas e incluyen el dominio.
Crea tu script
Copia y pega el siguiente script en la aplicación de PowerShell que prefieras.
# Import the ShareGate module
Import-Module Sharegate
# Define the path to the CSV file containing user and group mappings
$csvFile = "C:\CSVfile.csv"
# Import the CSV file into a table variable, specifying the delimiter as a comma
$table = Import-CSV $csvFile -Delimiter ","
# Create a new mapping settings object to store user and group mappings
$mappingSettings = New-MappingSettings
# Loop through each row in the imported CSV table
foreach ($row in $table) {
# Set user and group mappings for each row in the CSV file
$results = Set-UserAndGroupMapping -MappingSettings $mappingSettings -Source $row.SourceValue -Destination $row.DestinationValue
# Output the source value for each row (for debugging or tracking purposes)
$row.SourceValue
}
# Export the user and group mappings to a file
Export-UserAndGroupMapping -MappingSettings $mappingSettings -Path "C:\FolderName\FileName"
Ajusta tu script para que funcione según tus necesidades. Aquí tienes algunas recomendaciones:
$csvFile: Ajusta la ruta para que el script llame a tu archivo CSV.
$table: El delimitador es el símbolo que tu CSV usa para separar los elementos de las columnas. Asegúrate de que tu script use el mismo delimitador que tu archivo (puedes verificarlo rápidamente abriendo el CSV en el Bloc de notas).
foreach: Recorre los valores de tu archivo CSV. Puedes aprender más aquí.
$results: Los resultados se almacenan en una variable results en lugar de mostrarse en la ventana de PowerShell para evitar problemas de rendimiento.
$row.sourcevalue: Imprime el valor de origen, para que puedas seguir tu progreso.
Export-UserAndGroupMapping: Ajusta la ruta para guardar el nuevo archivo de asignación de usuarios de ShareGate Migrate (SGUM) en la ubicación y con el nombre que prefieras.
Uso del archivo SGUM
Puedes importar el archivo SGUM en un script de migración con la siguiente línea:
$mappingSettings = Import-UserAndGroupMapping -Path "C:\FolderName\FileName.sgum"
Luego, llama a la asignación en tu línea de Copy (funcionará con todas las opciones de copy como Copy-Site y Copy-Content). Agrega lo siguiente en la misma línea que tu comando de copy:
-MappingSettings $mappingSettings
También puedes importar el archivo SGUM con la opción de migración de ShareGate Migrate en Copy haciendo clic en el botón Import en el menú Map users and groups.
"Este artículo fue traducido usando inteligencia artificial. En caso de duda, consulta la versión original en inglés."