Nota: La integración con PowerShell requiere una suscripción Pro o Enterprise de ShareGate Migrate. No está disponible en el plan Essentials.
Los comandos de asignación de PowerShell replican las opciones de asignación que puedes usar en ShareGate Migrate, dándote mayor control sobre tu migración.
Comportamientos de asignación
Cuando configuras tus propias asignaciones en ShareGate Migrate, estas se guardan automáticamente para futuras migraciones que realices con el mismo origen y destino.
Las asignaciones de usuarios y grupos, niveles de permisos y plantillas de sitio se guardan a nivel de colección de sitios, aun si estás conectado a nivel de subsitio o lista cuando guardas tus asignaciones.
Las asignaciones de propiedades y tipos de contenido se guardan a nivel de lista.
Tipos de asignación
Puedes asignar varios elementos con ShareGate Migrate. Los tipos de asignación son:
Propiedades (Se usa solo con Copy-Content)
Tipos de contenido (Se usa solo con Copy-Content)
Plantillas de sitio (Se usa solo con Copy-Site)
Comandos de asignación
Hay seis comandos de PowerShell que puedes usar para cada tipo de asignación. Estos comandos son:
Set mapping: Crea nuevas asignaciones en tu script.
Export mapping: Exporta tus asignaciones como un archivo de asignación de ShareGate Migrate.
Import mapping: Importa tus asignaciones desde un archivo de asignación de ShareGate Migrate.
Get mapping: Obtiene las asignaciones guardadas para otro origen y destino.
Save mapping: Guarda tus asignaciones para un origen y destino.
Remove mapping: Elimina elementos de asignación específicos de las asignaciones existentes.
Nota: Configurar asignaciones en un script de PowerShell no las guarda automáticamente para tu origen y destino. Usa el comando Save mapping para conservar estas asignaciones para futuras migraciones.
Ejemplo
Mira cómo generar un archivo de asignación y crear un script con diferentes comandos de asignación. Los ejemplos muestran asignaciones de usuarios y grupos, que es un escenario común, pero puedes usar los mismos principios con todos los tipos de asignación.
Exportar un archivo de asignación desde la interfaz
Abre ShareGate Migrate.
Selecciona Copy en la barra de menú.
Selecciona Copy structure.
Conéctate a tu sitio de origen y destino.
Haz clic en Mappings.
Haz clic en el ícono Export user and group mappings.
Guarda el archivo SGUM en tu unidad.
Consejo: Consulta el artículo Crear una asignación de usuarios desde un archivo CSV para aprender cómo crear un archivo de asignación de usuarios complejo o para toda la empresa.
Usar asignaciones en un script de PowerShell
Import-Module Sharegate
# Crear un nuevo objeto de configuración de asignaciones
$mappings = New-MappingSettings
# Importar asignaciones de usuarios y grupos desde un archivo externo
$mappings = Import-UserAndGroupMapping -MappingSettings $mappings -Path "C:\MyMappings\MyUserAndGroupMappingsFileName.sgum"
# Configurar la asignación para usuarios o grupos no resueltos para que se asignen al 'Inactive users group'
$mappings = Set-UserAndGroupMapping -MappingSettings $mappings -UnresolvedUserOrGroup -Destination "Inactive users group"
# Configurar la asignación para un usuario específico de 'John Smith' a 'John Doe'
$mappings = Set-UserAndGroupMapping -MappingSettings $mappings -Source "John Smith" -Destination "John Doe"
# Eliminar una asignación específica para 'John Smith'
$mappings = Remove-UserAndGroupMapping -MappingSettings $mappings -Source "John Smith"
# Conectarse al sitio de origen
$srcSite = Connect-Site -Url "http://myfarm1/sites/mysourcesite"
# Conectarse al sitio de destino
$dstSite = Connect-Site -Url "http://myfarm1/sites/mydestinationsite"
# Copiar el sitio de origen al sitio de destino usando la configuración de asignaciones, habilitando la combinación y los subsitios
Copy-Site -Site $srcSite -DestinationSite $dstSite -MappingSettings $mappings -Merge -Subsites
New-MappingSettings: Este comando sobrescribe cualquier asignación que hayas guardado previamente para el origen y destino.
$mappings: Repetimos esta variable, agregando -MappingSettings $mappings en cada línea para añadir o quitar elementos de las asignaciones.
Import-UserAndGroupMapping: Esto importa un archivo de asignación de usuarios. El archivo puede contener muchas asignaciones de usuarios.
Set-UserAndGroupMapping: Agrega una nueva asignación de usuario. En este caso, agrega una asignación a las que estableciste con Import-UserAndGroupMapping.
-Source y -Destination: Define el valor que quieres asignar con -Source y el nuevo valor con -Destination.
-UnresolvedUserOrGroup: Puedes reemplazar -source por -UnresolvedUserOrGroup cuando quieras asignar todos los usuarios huérfanos a otra cuenta de usuario o grupo de seguridad (Active Directory).
Remove-UserAndGroupMapping: Elimina una asignación de usuario. En este caso, resta una asignación de usuario de las que estableciste en las líneas anteriores de $mappings.
Copy Site: El comando para copiar un sitio. Agrega -MappingSettings $mappings para aplicar las asignaciones que estableciste en la variable $mappings.
"Este artículo fue traducido usando inteligencia artificial. En caso de duda, consulta la versión original en inglés."