Migrace skupin z jedné doménové struktury do druhé pomocí služby Microsoft Entra Connect
Tento článek popisuje, jak migrovat skupiny z jednoho lesa do druhého, aby migrované objekty skupiny odpovídaly existujícím objektům v cloudu.
Požadavky
- Microsoft Entra Connect verze 1.5.18.0 nebo novější
- Atribut ukotvení zdroje nastavený na
mS-DS-ConsistencyGuid
Migrace skupin
Od verze 1.5.18.0 microsoft Entra Connect podporuje použití atributu mS-DS-ConsistencyGuid
pro skupiny. Pokud zvolíte mS-DS-ConsistencyGuid
jako atribut zdrojového ukotvení a hodnota je nastavena ve službě Active Directory, Microsoft Entra Connect použije hodnotu mS-DS-ConsistencyGuid
jako immutableId
. V opačném případě se vrátí zpět na použití objectGUID
. Všimněte si ale, že Microsoft Entra Connect nezapisuje hodnotu zpět do atributu mS-DS-ConsistencyGuid
ve službě Active Directory.
Během přesunu mezi lesy, kdy se skupinový objekt přesouvá z jednoho lesa (například F1) do jiného lesa (například F2), musíte zkopírovat buď hodnotu mS-DS-ConsistencyGuid
(pokud existuje) nebo hodnotu objectGUID
z objektu v lese F1 do atributu mS-DS-ConsistencyGuid
objektu v lese F2.
Následující skripty slouží jako návod pro migraci jedné skupiny z jedné doménové struktury do druhé. Tyto skripty můžete použít také jako vodítko pro migraci více skupin. Skripty používají název doménové struktury F1 pro zdrojovou doménovou strukturu a F2 pro cílovou doménovou strukturu.
Nejprve získáme objectGUID
a mS-DS-ConsistencyGuid
objektu skupiny v lese F1. Tyto atributy se exportují do souboru CSV.
<#
DESCRIPTION
============
This script will take DN of a group as input.
It then copies the objectGUID and mS-DS-ConsistencyGuid values along with other attributes of the given group to a CSV file.
This CSV file can then be used as input to the Export-Group script.
#>
Param(
[ValidateNotNullOrEmpty()]
[string]
$dn,
[ValidateNotNullOrEmpty()]
[string]
$outputCsv
)
$defaultProperties = @('samAccountName', 'distinguishedName', 'objectGUID', 'mS-DS-ConsistencyGuid')
$group = Get-ADGroup -Filter "DistinguishedName -eq '$dn'" -Properties $defaultProperties -ErrorAction Stop
$results = @()
if ($group -eq $null)
{
Write-Error "Group not found"
}
else
{
$objectGUIDValue = [GUID]$group.'objectGUID'
$mSDSConsistencyGuidValue = "N/A"
if ($group.'mS-DS-ConsistencyGuid' -ne $null)
{
$mSDSConsistencyGuidValue = [GUID]$group.'mS-DS-ConsistencyGuid'
}
$adgroup = New-Object -TypeName PSObject
$adgroup | Add-Member -MemberType NoteProperty -Name samAccountName -Value $($group.'samAccountName')
$adgroup | Add-Member -MemberType NoteProperty -Name distinguishedName -Value $($group.'distinguishedName')
$adgroup | Add-Member -MemberType NoteProperty -Name objectGUID -Value $($objectGUIDValue)
$adgroup | Add-Member -MemberType NoteProperty -Name mS-DS-ConsistencyGuid -Value $($mSDSConsistencyGuidValue)
$results += $adgroup
}
Write-Host "Exporting group to output file"
$results | Export-Csv "$outputCsv" -NoTypeInformation
Dále použijeme vygenerovaný výstupní CSV soubor k označení atributu mS-DS-ConsistencyGuid
na cílovém objektu v doménové struktuře F2.
<#
DESCRIPTION
============
This script will take DN of a group as input and the CSV file that was generated by the Import-Group script.
It copies either the objectGUID or the mS-DS-ConsistencyGuid value from the CSV file to the given object.
#>
Param(
[ValidateNotNullOrEmpty()]
[string]
$dn,
[ValidateNotNullOrEmpty()]
[string]
$inputCsv
)
$group = Get-ADGroup -Filter "DistinguishedName -eq '$dn'" -ErrorAction Stop
if ($group -eq $null)
{
Write-Error "Group not found"
}
$csvFile = Import-Csv -Path $inputCsv -ErrorAction Stop
$msDSConsistencyGuid = $csvFile.'mS-DS-ConsistencyGuid'
$objectGuid = [GUID] $csvFile.'objectGUID'
$targetGuid = $msDSConsistencyGuid
if ($msDSConsistencyGuid -eq "N/A")
{
$targetGuid = $objectGuid
}
Set-ADGroup -Identity $dn -Replace @{'mS-DS-ConsistencyGuid'=$targetGuid} -ErrorAction Stop
Další kroky
Zjistěte více o integraci místních identit s Microsoft Entra ID .