Nuta
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować się zalogować lub zmienić katalog.
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować zmienić katalogi.
W tym artykule opisano ogólny łącznik CSV. Artykuł dotyczy następujących produktów:
W przypadku programu MIM 2016 łącznik jest dostępny do pobrania z Centrum Pobierania Microsoft .
Notatka
Usługa provisioningu Azure AD udostępnia teraz uproszczone rozwiązanie z użyciem lekkiego agenta do provisioningu użytkowników do plików CSV bez potrzeby pełnego wdrażania synchronizacji MIM. Zalecamy ocenę, czy spełnia Twoje potrzeby. Dowiedz się więcej.
Przygotowywanie przykładowych plików CSV
Na serwerze z uruchomionym serwerem synchronizacji programu MIM utwórz folder C:\GCSV i skopiuj do niego następujące pliki CSV znajdujące się w dodatku A — przykładowe pliki CSV. Pamiętaj, aby przyznać kontu usługi synchronizacji MIM zarówno uprawnienia do odczytu, jak i zapisu do tego folderu.
Skopiuj następujący plik CSV do folderu C:\GCSV\SCRIPTS:
- Przykładowy plik CSV użytkowników (Users.csv)
- Przykładowy plik CSV grup (Groups.csv)
- Przykładowy plik CSV członków (Members.csv)
Notatka
W tym przewodniku założono, że pliki CSV znajdują się w następującej ścieżce na serwerze synchronizacji programu MIM: C:\GCSV i że są zapisywane przy użyciu wskazanych nazw plików. Jeśli zainstalujesz je w innej lokalizacji lub zmienisz ich nazwę, musisz wprowadzić odpowiednie zmiany za pomocą resetowania tego przewodnika.
Przygotowywanie przykładowych skryptów programu PowerShell
Na serwerze z uruchomionym serwerem synchronizacji programu MIM utwórz folder C:\GCSV\SCRIPTS i skopiuj do niego przykładowe skrypty programu PowerShell znajdujące się w dodatku Dodatek B — przykładowe pliki programu PowerShell. Upewnij się, że konto usługi synchronizacji programu MIM ma odpowiednie uprawnienia ExecutePolicy programu PowerShell w celu wykonania skryptów.
Skopiuj następujące skrypty programu PowerShell do folderu C:\GCSV\SCRIPTS:
- Przykładowy skrypt przed zaimportowania (Pre-Import.ps1)
- Przykładowy skrypt po zaimportowaniu (Post-Import.ps1)
- Przykładowy skrypt przed wyeksportowania (Pre-Export.ps1)
- Przykładowy skrypt po wyeksportowaniu (Post-Export.ps1)
Notatka
W tym przewodniku założono, że pliki CSV znajdują się w następującej ścieżce na serwerze synchronizacji programu MIM: C:\GCSV\SCRIPTS. Jeśli zainstalujesz je w innej lokalizacji, konieczne będzie wprowadzenie odpowiednich zmian za pomocą resetowania tego przewodnika.
Ważny
Konto usługi synchronizacji programu MIM wymaga odpowiednich uprawnień ExecutePolicy programu PowerShell na serwerze synchronizacji programu MIM w celu wykonania przykładowych skryptów programu PowerShell.
Tworzenie nowego łącznika
Poniższa lista zawiera ogólne omówienie kroków opisanych w tym przewodniku. Aby to zrobić, należy użyć konta z rolą administratora synchronizacji MIM, aby wykonać te zadania:
- Otwórz okno Utwórz nowego agenta zarządzania (MA) z programu MIM Sync Service Manager.
- Wybierz łącznik CSV ogólny jako typ łącznika.
- Podaj ścieżkę pliku i nazwę pliku CSV do zaimportowania lub wyeksportowania.
- Określ kodowanie pliku, separator wartości, separator wielu wartości i kwalifikator tekstu dla pliku CSV.
- Określ, czy wartości w pierwszym wierszu mają być używane jako pola nagłówka, czy nie.
- Wybierz typy obiektów i atrybuty do zaimportowania lub wyeksportowania z pliku CSV.
- Skonfiguruj partycję, profil uruchomieniowy i szczegóły mapowania dla MA.
- Podaj ścieżki i parametry skryptów programu PowerShell, jeśli istnieją.
- Uruchom narzędzie MA, aby wykonać operacje importowania, synchronizacji lub eksportowania.
- Oceń wyniki.
Zacznijmy!
Aby utworzyć ogólny łącznik CSV, w programie MIM Synchronization Service Manager wybierz pozycję Management Agent i Utwórz. Wybierz konektor Generic CSV (Microsoft) Connector.
Podaj nazwę łącznika (na przykład: Generic CSV) i kliknij przycisk Dalej.
Łączność
Strona Łączność zawiera ścieżki plików, w których łącznik może zlokalizować pliki CSV użytkowników, grup i członków grupy.
Na poniższej ilustracji przedstawiono przykład strony Connectivity:
Poniżej znajduje się lista wartości, które powinny zostać podane dla ustawień na tej stronie:
| Nazwa ustawienia | Wartość ustawienia | Notatki |
|---|---|---|
| plik użytkowników | C:\GCSV\USERS.CSV | (Używana w pełni kwalifikowana ścieżka i nazwa pliku). |
| plik grup | C:\GCSV\GROUPS.CSV | (Używana w pełni kwalifikowana ścieżka i nazwa pliku). |
| plik członków | C:\GCSV\MEMBERS.CSV | (Pełna ścieżka kwalifikowana i nazwa pliku używana). |
Po sprawdzeniu, czy ustawienia są zgodne z podanymi wartościami, kliknij przycisk Dalej.
Możliwości
Na tej stronie opisano możliwości łącznika. Możliwości łącznika GCSV są stałe i nie można ich modyfikować.
Na poniższej ilustracji przedstawiono przykład strony możliwości:
Aby uzyskać szczegółowy opis tych ustawień funkcji, zapoznaj się z Generic CSV Connector — Technical Reference Guide.
Po przejrzeniu ustawień kliknij przycisk Dalej.
Schemat 1 (konfiguracje formatu pliku CSV)
Łącznik Generic CSV (GCSV) wykorzystuje trzy rodzaje separatorów (lub ograniczników) do delimitacji i analizowania pól CSV oraz ich wartości: separatory wartości , separatory wielowartościowe , oraz kwalifikatory tekstu . Aby uzyskać więcej szczegółowych informacji na temat tych typów ograniczników, zobacz Generic CSV Connector — Technical Reference Guide
Ta strona zawiera ustawienia wartości znaków dla tych ograniczników i typ kodowania, który został użyty do utworzenia pliku CSV.
Na poniższej ilustracji przedstawiono przykład strony Schemat 1 (konfiguracje formatu plików CSV):
schematu 1 (konfiguracje formatu plików CSV)
Poniższa sekcja zawiera listę poszczególnych konfiguracji:
- Używanie nagłówków do wykrywania schematu: Jeśli ta opcja jest zaznaczona, powoduje, że łącznik ignoruje pierwszy rekord każdego pliku CSV jako rekord danych i używa go jako rekordu nagłówka (to znaczy, że zawiera nazwy każdego pola). Jeśli ta opcja nie jest zaznaczona, łącznik nadaje ogólną nazwę każdemu polu (na przykład Attribute1, Attribute2 itp.) i używa pierwszego wiersza jako rekordu danych.
- separator wartości: ten znak oddziela pola (czyli wartości) rekordów CSV. Przecinek (,) jest domyślny, ale dozwolony jest dowolny znak alfanumeryczny, który można wydrukować.
- separatora wielowartościowego: ten typ separatora służy do rozdzielenia poszczególnych wartości ciągu wielowartościowego (na przykład adresów serwera proxy) lub atrybutów referencyjnych (na przykład podrzędnych). Wartość domyślna to średnik (;) ale dowolny znak alfanumeryczny z możliwością drukowania jest akceptowalny.
- kwalifikator tekstu: jeśli wartość ciągu zawiera znaki, które w przeciwnym razie będą interpretowane jako ograniczniki (na przykład przecinki), wymaga, aby wartość była kwalifikowana, aby analizator CSV mógł poprawnie interpretować ciąg jako jedno pole. Cudzysłowy (") są domyślne, ale dozwolony jest dowolny znak alfanumeryczny, który można wydrukować.
- kodowanie plików: to ustawienie wskazuje kodowanie używane w plikach CSV dodanych na karcie Łączność. Upewnij się, że jest on zgodny z kodowaniem plików CSV.
Notatka
Jeśli nie masz pewności co do typu kodowania plików CSV, spróbuj użyć domyślnego typu kodowania Unicode. Unicode jest typowym standardem obsługującym wiele znaków i symboli, dzięki czemu jest używany jako dobra opcja kodowania danych tekstowych w większości języków lub zestawów znaków.
Schemat 2 (konfiguracje pól tożsamości i odwołania)
Wartość referencyjna jest unikatowym identyfikatorem rekordu w pliku CSV. Odróżnia jeden rekord od innych. Łącznik GCSV używa również tej wartości do skompilowania nazwy wyróżniającej (DN), która jednoznacznie identyfikuje swój obiekt przestrzeni łącznika.
Na tej stronie ustawienia atrybutu kotwicy są konfigurowane dla każdego z plików CSV wymienionych na stronie Łączność.
Na poniższej ilustracji przedstawiono przykład strony schematu 2 (konfiguracja tożsamości i pola odwołania).
W poniższej tabeli przedstawiono poszczególne wartości, które powinny być przypisane do każdego z ustawień na tej stronie:
| Nazwa ustawienia | Wartość ustawienia |
|---|---|
| Pole ID rekordu użytkowników | ID pracownika |
| typ atrybutu pola rekordu użytkownika | ciąg |
| pola identyfikatora rekordu grupy | GroupID |
| atrybut typu pola ID rekordu grupy | string |
| identyfikator grupy nadrzędnej | parentID |
| identyfikator członka | ID członka |
| Typ obiektu członkowskiego | ObjectType |
Po sprawdzeniu, czy ustawienia są zgodne z podanymi wartościami, kliknij przycisk Dalej.
Schemat 3 (konfiguracje schematu atrybutów plików użytkowników)
Ta strona służy do przypisywania typu danych dla każdego atrybutu w schemacie pliku CSV użytkownicy oraz określenia, czy mogą mieć więcej niż jedną wartość.
Na poniższej ilustracji przedstawiono przykład strony schematu 3 (konfiguracja schematu atrybutu pliku użytkowników).
W poniższej tabeli przedstawiono poszczególne wartości, które powinny być przypisane do każdego z ustawień na tej stronie:
| Nazwa ustawienia | Wartość ustawienia | Notatki |
|---|---|---|
| typ atrybutu DisplayName | ciąg | Przykłady kwalifikowanych ciągów znajdują się w tym polu |
| DisplayName jest wielowartościowy | false | -- |
| Typ atrybutu AccountName | ciąg | -- |
| AccountName ma wielokrotne wartości | fałsz | -- |
| typ atrybutu CountryCode | liczba całkowita | -- |
| KodKraju ma wiele wartości | fałsz | -- |
| Manager typ atrybutu | Referencja | Zawiera wartości atrybutów kotwicy z rekordu użytkownika przypisanego menedżera (na przykład E001) |
| Menedżer jest wielowartościowy | false | -- |
| typ atrybutu ProxyAddresses | ciąg | -- |
| ProxyAddresses jest wielowartościowe | prawda | Zawiera przykłady ograniczeń ciągów wielowartościowych |
| IsActive typ atrybutu | logiczne typu Boolean | -- |
| IsActive jest wielowartościowe | fałsz | -- |
| Atrybut typu ProfilePic | binarne | -- |
| Zdjęcie profilowe jest polem wielowartościowym | fałsz | -- |
Po sprawdzeniu, czy ustawienia są zgodne z podanymi wartościami, kliknij przycisk Dalej.
Schemat 4 (grupy konfiguracji schematu atrybutu pliku)
Ta strona służy do przypisywania typu danych dla każdego atrybutu w schemacie pliku CSV grupy i tego, czy mogą mieć więcej niż jedną wartość.
Na poniższej ilustracji przedstawiono przykład strony schematu 4 (konfiguracje schematu atrybutów plików grup).
W poniższej tabeli przedstawiono poszczególne wartości, które powinny być przypisane do każdego z ustawień na tej stronie:
| Nazwa ustawienia | Wartość ustawienia | Notatki |
|---|---|---|
| typ atrybutu DisplayName | łańcuch | -- |
| DisplayName jest wielowartościowe | false | Zawiera przykład kwalifikowanych wartości ciągów. |
| opis typu atrybutu | łańcuch | -- |
| opis jest wielowartościowy | false | -- |
| typ atrybutu właściciela | referencja | Zawiera przykład wartości referencyjnych. |
| Właściciel jest wielowartościowy | fałsz | -- |
Po sprawdzeniu, czy ustawienia są zgodne z podanymi wartościami, kliknij przycisk Dalej.
Parametry globalne (konfiguracja skryptów programu PowerShell)
Ta strona umożliwia konfigurację skryptów programu PowerShell, które będą uruchamiane przed i/lub po operacjach importowania i/lub eksportowania. Wartość tych parametrów wejściowych zapewnia możliwość wykonywania różnych akcji przetwarzania wstępnego i końcowego na rekordach użytkowników tożsamości i grup.
Na poniższej ilustracji przedstawiono przykład strony parametrów globalnych.
W poniższej tabeli przedstawiono poszczególne wartości, które powinny być przypisane do każdego z ustawień na tej stronie:
| Nazwa ustawienia | Wartość ustawienia | Notatki |
|---|---|---|
| Plik przed importem | C:\GCSV\SCRIPTS\PRE-IMPORT.CSV | Ten skrypt jest wykonywany przed pełnym importowaniem |
| po zaimportowania pliku | C:\GCSV\SCRIPTS\POST-IMPORT.CSV | Ten skrypt jest wykonywany po pełnym zaimportowaniu |
| Plik przed wyeksportowaniem | C:\GCSV\SCRIPTS\PRE-EXPORT.CSV | Ten skrypt jest wykonywany przed pełnym eksportem lub eksportem (delta) |
| Plik po wyeksportowaniu | C:\GCSV\SCRIPTS\POST-EXPORT.CSV | Ten skrypt jest wykonywany przed pełnym eksportem lub eksportem (delta) |
Po sprawdzeniu, czy ustawienia są zgodne z podanymi wartościami, kliknij przycisk Dalej.
Wykonywanie skryptu programu PowerShell
Łącznik GCSV uruchamia każdy skonfigurowany skrypt programu PowerShell we własnej sesji i nie zapewnia obsługi przekazywania zmiennych między wykonywaniem skryptów.
Ponadto łącznik GCSV wykonuje skrypt programu PowerShell wewnątrz plików, a nie jako polecenie cmdlet. Oznacza to, że nie można przekazać parametrów wejściowych do skryptów przez dodanie ich na końcu instrukcji path. W ten sposób wykonanie skryptu zakończy się niepowodzeniem.
Ważny
Łącznik GCSV nie obsługuje używania przekazywania parametrów wejściowych w wykonywaniu skryptów programu PowerShell.
Jeśli wykonanie skryptu przed zaimportowaniem lub przed wyeksportowaniem zgłasza wyjątek, aby zapobiec importowaniu lub eksportowaniu nieprawidłowo przetworzonych rekordów użytkownika lub grupy, łącznik GCSV zostanie przerwany i zatrzyma wykonywanie całego profilu uruchamiania.
Podobnie, jeśli operacja po zaimportowaniu lub po wyeksportowaniu napotka wyjątek, status operacji kończy się niepowodzeniem.
Błędy napotkane podczas wykonywania skryptu programu PowerShell zostaną zarejestrowane w dzienniku zdarzeń serwera synchronizacji programu MIM.
Parametr wejściowy programu PowerShell: OperationType
Mimo że użycie parametrów wejściowych nie jest obsługiwane, łącznik GCSV przekazuje jeden parametr wejściowy do wykonywania każdego skryptu programu PowerShell: OperationType.
Zmienna wejściowa OperationType będzie mieć wartość Full lub Delta, aby pokazać rodzaj operacji (na przykład Full Import, Delta Import, Full Export, (Delta) Export), która jest uruchomiona za pomocą skryptem. Ta zmienna umożliwia skryptom sprawdzenie, czy są uruchamiane w kontekście pełnego lub różnicowego importu/eksportu oraz odpowiednio wykonywać swoje zadania przed lub po przetwarzaniu.
Hierarchia wdrażania
Ponieważ pliki CSV nie przechowują informacji w strukturze hierarchicznej; Ogólny łącznik CSV nie obsługuje żadnych hierarchii konfiguracji aprowizacji.
Na poniższym obrazie przedstawiono przykład strony hierarchii aprowizacji .
Po sprawdzeniu, czy ustawienia są zgodne z podanymi wartościami, kliknij przycisk Dalej.
Partycje i hierarchie
Ogólny łącznik CSV tworzy odrębną nazwę wyróżniającą (DN) dla każdego rekordu użytkownika i grupy w przestrzeni łącznika, zgodnie z następującym formatem LDAP:
CN=[ANCHOR_VALUE],Object=User|Group,O=CSV
Na poniższej ilustracji przedstawiono przykład strony Partitions and Hierarchies (Partycje i hierarchie).
Po sprawdzeniu, czy ustawienia są zgodne z podanymi wartościami, kliknij przycisk Dalej.
Typy obiektów
Ogólny łącznik CSV wymaga określenia co najmniej typu obiektu Użytkownik. Wybór typu obiektu Grupa jest opcjonalny.
Na poniższej ilustracji przedstawiono przykład strony Typy obiektów.
Po sprawdzeniu, czy ustawienia są zgodne z podanymi wartościami, kliknij przycisk Dalej.
Atrybuty
Na tej stronie zostanie wyświetlona znormalizowana lista wszystkich atrybutów we wszystkich wybranych schematach typów obiektów.
Na poniższym obrazie przedstawiono przykład strony Atrybuty.
Po sprawdzeniu, czy ustawienia są zgodne z podanymi wartościami, kliknij przycisk Dalej.
Notatka
Atrybuty kotwicy są zawsze wymagane, aby łącznik GCSV działał prawidłowo.
Kotwice
Ogólny łącznik CSV nie obsługuje używania złożonych kotwic ani konfiguracji atrybutów kotwicy, które różnią się od oznaczenia pola anchor ID odpowiedniego pliku CSV obiektu. Dlatego pola wyboru kotwicy są zablokowane. Aby wprowadzić zmianę w oznaczeniu atrybutu kotwicy, wróć do strony Schema 2 (Konfiguracje pól tożsamości i odwołań).
Na poniższej ilustracji przedstawiono przykład strony Anchors.
Po przejrzeniu ustawień domyślnych na stronie kliknij przycisk Dalej.
Filtry łączników
Ten poradnik nie będzie korzystał z żadnych konfiguracji filtrów łącznika. Ta sekcja jest tutaj, aby zapewnić ciągłość w przewodniku.
Na poniższym obrazie przedstawiono przykład strony filtrów łącznika .
Po przejrzeniu ustawień domyślnych na stronie kliknij przycisk Dalej.
Reguły łączenia i projekcji
Ten przewodnik nie będzie używać żadnych konfiguracji reguł sprzężenia i projekcji. Ta sekcja jest tutaj, aby zapewnić ciągłość w przewodniku.
Na poniższym obrazie przedstawiono przykład strony z Regułami sprzężeń i projekcji .
Po przejrzeniu ustawień domyślnych na stronie kliknij przycisk Dalej.
Przepływ atrybutów
Ten przewodnik nie będzie używać żadnych konfiguracji reguł przepływu atrybutów. Ta sekcja jest tutaj, aby zapewnić ciągłość w przewodniku.
Na poniższej ilustracji przedstawiono przykład strony Przepływ atrybutów.
Po sprawdzeniu, czy ustawienia są zgodne z wartościami domyślnymi, kliknij przycisk Dalej.
Anulowanie aprowizacji
W tym przewodniku nie zmienimy domyślnych ustawień anulowania aprowizacji tego łącznika. Ta sekcja jest tutaj, aby zapewnić ciągłość w przewodniku.
Na poniższej ilustracji przedstawiono przykład strony deprowizjonowania.
Po sprawdzeniu, czy ustawienia są zgodne z wartościami domyślnymi, kliknij przycisk Dalej.
Tworzenie pełnego profilu uruchamiania importu
Do zaimportowania danych tożsamości użytkownika i grupy z rekordów CSV do obiektów Obszaru łącznika wymagany jest pełny profil uruchamiania importu.
Aby utworzyć nowy profil uruchamiania pełnego importu, wykonaj następujące czynności:
- Wróć do menedżera usług synchronizacji Synchronization Service Manager.
- Wybierz agenta zarządzania GCSV.
- Kliknij go prawym przyciskiem myszy i wybierz pozycję Konfiguruj profile uruchamiania.
- Kliknij Nowy Profil.
Zostanie wyświetlone okno Konfigurowanie profilu uruchamiania.
Nadaj nazwę profilowi uruchamiania
Na stronie Nazwa profilu wprowadź nazwę Full Import
Na poniższej ilustracji przedstawiono przykład strony Profil.
Po sprawdzeniu, czy ustawienia są zgodne z podanymi wartościami, kliknij przycisk Dalej.
Określ typ
Na stronie Konfigurowanie kroku wybierz pozycję Typ: Pełny import.
Filtrowanie łącznika działa tak samo w łączniku GCSV, jak w przypadku dowolnego innego łącznika ECMA.
Na poniższej ilustracji przedstawiono przykład strony filtru łącznika .
Po sprawdzeniu, czy ustawienia są zgodne z podanymi wartościami, kliknij przycisk Dalej.
Typ konfiguracji agenta zarządzania
Na stronie Typ konfiguracji agenta zarządzania upewnij się, że wybrano partycję O=CSV.
Pozostaw pozostałe ustawienia w ich wartościach domyślnych. Kliknięcie przycisku Zakończ spowoduje utworzenie profilu działania.
Sprawdzanie poprawności wyników
W tej sekcji opisano kroki niezbędne do zweryfikowania wyników tworzenia nowego łącznika GCSV i importowania rekordów użytkownika i grupy z przykładowych plików CSV.
Uruchamianie pełnego importu
Po utworzeniu profilu uruchamiania wykonaj następujące kroki, aby uruchomić ten nowy profil uruchomienia pełnego importu:
- Wróć do programu Synchronization Service Manager.
- Wybierz agenta zarządzania GCSV.
- Kliknij go prawym przyciskiem myszy i wybierz pozycję Uruchom.
- Wybierz pozycję Full Import i kliknij przycisk OK.
Sprawdzanie poprawności wyników pełnej operacji importowania
Na podstawie zawartości przykładowych plików CSV powinno istnieć pięć (5) dodatków.
Na poniższej ilustracji przedstawiono przykład wyników pomyślnego zaimportowania zawartości przykładowych plików CSV:
Sprawdzanie przestrzeni łącznika GCSV
Po utworzeniu profilu uruchamiania wykonaj następujące kroki, aby uruchomić ten nowy profil uruchomienia pełnego importu:
- Wróć do programu Synchronization Service Manager.
- Wybierz agenta zarządzania łącznika GCSV.
- Kliknij go prawym przyciskiem myszy i wybierz pozycję Przeszukaj przestrzeń łącznika.
- Pozostaw zakres do wartości domyślnej Subtree i kliknij przycisk Wyszukaj.
Na poniższej ilustracji przedstawiono przykład okna obszaru łącznika wyszukiwania, które zostanie wyświetlone.
Weryfikowanie obiektu użytkownika
Wybierz jeden z obiektów użytkownika do inspekcji. Na poniższej ilustracji przedstawiono przykład obiektu przestrzeni łącznika GCSV użytkownika:
Badanie pola DisplayName pokazuje, jak kwalifikowany ciąg został prawidłowo przeanalizowany.
Kliknięcie przycisku w wpisie ProxyAddresses ujawnia, że ciąg wielowartościowy został również prawidłowo przeanalizowany do poszczególnych wartości.
Weryfikowanie obiektu grupy
Wybranie jednego z obiektów grupy do inspekcji. Na poniższej ilustracji przedstawiono przykład obiektu przestrzeni łącznika GCSV grupy:
Kliknięcie przycisku w pozycji członek ujawnia, w jaki sposób skojarzone rekordy grupy są ładowane jako rekordy członków w pliku Członków:
Weryfikowanie dzienników wykonywania programu PowerShell
Przykładowe skrypty programu PowerShell podane w tym przewodniku zostały zaprojektowane tak, aby dodać wpis CSV do centralnego dziennika w celu zademonstrowania pomyślnego wykonania.
Domyślną lokalizacją tego dziennika jest C:\GCSV\PS_Run_Ledger.csv.
Otwarcie dziennika ujawnia:
"DateTime","Stage","Name","Type","Description"
"3/17/2024 1:05:44 PM","Pre","Import","Full","The Pre-Import PowerShell script was executed successfully."
"3/17/2024 1:05:46 PM","Pre","Import","Full","The Post-Import PowerShell script was executed successfully."
Te dwa rekordy wskazują, że skrypty programu PowerShell przed importowaniem i po zaimportowaniu zostały pomyślnie uruchomione. Zwróć uwagę, że pole Typ wskazuje, że te skrypty programu PowerShell zostały uruchomione podczas pełnego importu. Uzyskuje te wartości z parametru wejściowego OperationType programu PowerShell, który wskazuje, czy skrypt został uruchomiony podczas operacji pełnej, czy delty.
Dodatek A — przykładowe pliki CSV
Poniższe sekcje zawierają pliki CSV używane w tym przewodniku.
Przykładowy plik CSV użytkowników
W konfiguracji konektora ten przewodnik zakłada, że nazwa pliku to USERS.CSV.
EmployeeID,DisplayName,AccountName,CountryCode,Manager,ProxyAddresses,IsActive,ProfilePic
E001,"Smith, John",JS001,1,,SMTP:john.smith@contoso.com;smtp:js001@contoso.com,True,SgBTADAAMAAxAA==
E002,"Doe, Jane",JD003,1,E001,SMTP:jane.doe@contoso.com;smtp:jd002@contoso.com,True,SgBEADAAMAAyAA==
E003,"Perez, Juan",JP003,1,E001,SMTP:juan.perez@contoso.com;smtp:jp003@contoso.com,False,SgBEADAAMAAyAA==
Przykładowy plik CSV dla grup
W konfiguracji łącznika niniejszy przewodnik zakłada, że nazwa pliku to GROUPS.CSV.
GroupID,DisplayName,Description,Owner
G001,Test Group (G001),"This group is for teams A, B, and C",E002
G002,Test Group (G002),"This group is for teams D, E, and F",E003
Przykładowy plik CSV członków
W konfiguracji łącznika w tym przewodniku założono, że nazwa pliku to MEMBERS.CSV.
ParentID,MemberID,ObjectType
G001,E001,USER
G001,E002,USER
G001,E003,USER
G002,E001,USER
G002,E002,USER
G002,E003,USER
G002,G001,GROUP
G003,E001,USER
G003,E002,USER
G003,E003,USER
G003,G001,GROUP
Dodatek B — przykładowe pliki programu PowerShell
Zawarte w tym dodatku to zestaw przykładowych skryptów programu PowerShell używanych w tym przewodniku. W następnych sekcjach omówiono niektóre z kwestii, które warto uwzględnić podczas
Ważny
użycie poleceń write-hostw skryptach PowerShell spowoduje niepowodzenie wykonania skryptu.
Przykładowy skrypt przed zaimportowania programu PowerShell
W konfiguracji łącznika w tym przewodniku przyjmuje się, że nazwa pliku to PRE-IMPORT.PS1.
param ([string]$OperationType)
[string]$stage = "Pre"
[string]$operation = "Import"
[string]$filePath = "C:\GCSV\PS_Run_Ledger.csv"
# Create a new record
$record = [PSCustomObject]@{
"DateTime" = (Get-Date).ToString()
"Stage" = $stage
"Type" = $OperationType
"Name" = $operation
"Description" = "The $stage-$operation PowerShell script was successfully executed before a $OperationType-$operation."
}
$record | Export-Csv -Path $FilePath -NoTypeInformation -Append
Przykładowy skrypt po zaimportowania programu PowerShell
W konfiguracji łącznika założono w tym przewodniku, że nazwa pliku to POST-IMPORT.PS1.
param ([string]$OperationType)
[string]$stage = "Post"
[string]$operation = "Import"
[string]$filePath = "C:\GCSV\PS_Run_Ledger.csv"
# Create a new record
$record = [PSCustomObject]@{
"DateTime" = (Get-Date).ToString()
"Stage" = $stage
"Type" = $OperationType
"Name" = $operation
"Description" = "The $stage-$operation PowerShell script was successfully executed after a $OperationType-$operation."
}
$record | Export-Csv -Path $FilePath -NoTypeInformation -Append
Przykładowy skrypt programu PowerShell przed eksportem
W konfiguracji łącznika w tym przewodniku założono, że nazwa pliku to PRE-EXPORT.PS1.
param ([string]$OperationType)
[string]$stage = "Pre"
[string]$operation = "Export"
[string]$filePath = "C:\GCSV\PS_Run_Ledger.csv"
# Create a new record
$record = [PSCustomObject]@{
"DateTime" = (Get-Date).ToString()
"Stage" = $stage
"Type" = $OperationType
"Name" = $operation
"Description" = "The $stage-$operation PowerShell script was successfully executed before a $OperationType-$operation."
}
$record | Export-Csv -Path $FilePath -NoTypeInformation -Append
Przykładowy skrypt programu PowerShell po wyeksportowania
W konfiguracji łącznika przyjęto w tym przewodniku, że nazwa pliku to POST-EXPORT.PS1.
param ([string]$OperationType)
[string]$stage = "Post"
[string]$operation = "Export"
[string]$filePath = "C:\GCSV\PS_Run_Ledger.csv"
# Create a new record
$record = [PSCustomObject]@{
"DateTime" = (Get-Date).ToString()
"Stage" = $stage
"Type" = $OperationType
"Name" = $operation
"Description" = "The $stage-$operation PowerShell script was successfully executed after a $OperationType-$operation."
}
$record | Export-Csv -Path $FilePath -NoTypeInformation -Append