Invoke-AzStorageSyncChangeDetection
To polecenie może służyć do ręcznego inicjowania wykrywania zmian przestrzeni nazw. Może być przeznaczony dla całego udziału, podfolderu lub zestawu plików. Podczas uruchamiania polecenia z parametrami -DirectoryPath lub -Path można wykryć maksymalnie 10 000 elementów. Jeśli zakres zmian jest znany, ogranicz wykonywanie tego polecenia do części przestrzeni nazw, dzięki czemu wykrywanie zmian może zakończyć się szybko i w ramach limitu 10 000 elementów. Możesz też uniknąć limitu elementów, uruchamiając polecenie cmdlet bez tych parametrów, wywołując wykrywanie zmian na poziomie udziału.
Uwaga
Jeśli uruchom polecenie z parametrami -DirectoryPath lub -Path, polecenie nie wykryje następujących zmian w udziale plików platformy Azure:
- Usunięte pliki.
- Pliki, które są przenoszone z udziału.
- Pliki, które są usuwane i tworzone o tej samej nazwie.
Jeśli zostanie wywołane wykrywanie zmian na poziomie udziału, zostaną wykryte wszystkie te zmiany. Te zmiany zostaną również wykryte po uruchomieniu zaplanowanego zadania wykrywania zmian.
Składnia
Invoke-AzStorageSyncChangeDetection
[-ResourceGroupName] <String>
[-StorageSyncServiceName] <String>
[-SyncGroupName] <String>
-Name <String>
[-PassThru]
[-AsJob]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Invoke-AzStorageSyncChangeDetection
[-ResourceGroupName] <String>
[-StorageSyncServiceName] <String>
[-SyncGroupName] <String>
-Name <String>
-DirectoryPath <String>
[-Recursive]
[-PassThru]
[-AsJob]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Invoke-AzStorageSyncChangeDetection
[-ResourceGroupName] <String>
[-StorageSyncServiceName] <String>
[-SyncGroupName] <String>
-Name <String>
-Path <String[]>
[-PassThru]
[-AsJob]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Invoke-AzStorageSyncChangeDetection
[-ResourceId] <String>
-DirectoryPath <String>
[-Recursive]
[-PassThru]
[-AsJob]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Invoke-AzStorageSyncChangeDetection
[-ResourceId] <String>
-Path <String[]>
[-PassThru]
[-AsJob]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Invoke-AzStorageSyncChangeDetection
[-ResourceId] <String>
[-PassThru]
[-AsJob]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Invoke-AzStorageSyncChangeDetection
[-InputObject] <PSCloudEndpoint>
-DirectoryPath <String>
[-Recursive]
[-PassThru]
[-AsJob]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Invoke-AzStorageSyncChangeDetection
[-InputObject] <PSCloudEndpoint>
-Path <String[]>
[-PassThru]
[-AsJob]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Invoke-AzStorageSyncChangeDetection
[-InputObject] <PSCloudEndpoint>
[-PassThru]
[-AsJob]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Opis
Okresowo usługa Azure File Sync sprawdza przestrzeń nazw wewnątrz synchronizowanego udziału plików platformy Azure pod kątem zmian wstępnych w udziale plików w inny sposób niż synchronizacja. Celem jest zidentyfikowanie tych zmian i ostatecznie zsynchronizowanie ich z połączonymi serwerami. To polecenie może służyć do ręcznego inicjowania wykrywania zmian przestrzeni nazw. Może być przeznaczony dla całego udziału, podfolderu lub zestawu plików. Jeśli zakres zmian jest znany, ogranicz wykonywanie tego polecenia do części przestrzeni nazw, więc wykrywanie zmian poszczególnych elementów może zakończyć się szybko i w ramach limitu 10 000 elementów. W przeciwnym razie uruchom polecenie bez parametrów -DirectoryPath lub -Path, aby wywołać pełne wykrywanie zmian na poziomie udziału. Polecenie cmdlet Invoke-AzStorageSyncChangeDetection anuluje zadanie wyliczania zmian w chmurze, które jest w toku. Aby uniknąć anulowania aktualnie uruchomionego zadania, przejdź do właściwości punktu końcowego chmury w portalu, aby sprawdzić, czy zadanie jest aktualnie uruchomione.
Przykłady
Przykład 1
Invoke-AzStorageSyncChangeDetection -ResourceGroupName "myResourceGroup" -StorageSyncServiceName "myStorageSyncServiceName" -SyncGroupName "mySyncGroupName" -CloudEndpointName "b38fc242-8100-4807-89d0-399cef5863bf" -Path "Data","Reporting\Templates"
W tym przykładzie wykrywanie zmian jest uruchamiane w katalogach "Dane" i "Reporting\Templates" synchronizowanego udziału plików platformy Azure. Wszystkie ścieżki są względne względem katalogu głównego przestrzeni nazw udziału plików platformy Azure.
Przykład 2
Invoke-AzStorageSyncChangeDetection -ResourceGroupName "myResourceGroup" -StorageSyncServiceName "myStorageSyncServiceName" -SyncGroupName "mySyncGroupName" -CloudEndpointName "b38fc242-8100-4807-89d0-399cef5863bf" -Path "Data\results.xslx","Reporting\Templates\generated.pptx"
W tym przykładzie wykrywanie zmian jest uruchamiane dla zestawu plików, które są znane obiektowi wywołującego polecenie, które uległy zmianie. Celem jest wykrycie i zsynchronizowanie tych zmian w usłudze Azure File Sync.
Przykład 3
Invoke-AzStorageSyncChangeDetection -ResourceGroupName "myResourceGroup" -StorageSyncServiceName "myStorageSyncServiceName" -SyncGroupName "mySyncGroupName" -CloudEndpointName "b38fc242-8100-4807-89d0-399cef5863bf" -DirectoryPath "Examples" -Recursive
W tym przykładzie wykrywanie zmian jest uruchamiane dla katalogu "Przykłady" i cyklicznie wykrywa zmiany w podkatalogach. Pamiętaj, że polecenie cmdlet zakończy się niepowodzeniem, jeśli ścieżka zawiera więcej niż 10 000 elementów. Jeśli ścieżka zawiera więcej niż 10 000 elementów, uruchom polecenie w podrzędnych częściach przestrzeni nazw.
Przykład 4
Invoke-AzStorageSyncChangeDetection -ResourceGroupName "myResourceGroup" -StorageSyncServiceName "myStorageSyncServiceName" -SyncGroupName "mySyncGroupName" -CloudEndpointName "b38fc242-8100-4807-89d0-399cef5863bf"
W tym przykładzie do polecenia nie przekazano parametru -DirectoryPath ani -Path. Spowoduje to wywołanie wykrywania zmian w całym udziale plików.
Parametry
-AsJob
Uruchamianie polecenia cmdlet w tle
Typ: | SwitchParameter |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-Confirm
Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.
Typ: | SwitchParameter |
Aliasy: | cf |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-DefaultProfile
Poświadczenia, konto, dzierżawa i subskrypcja używane do komunikacji z platformą Azure.
Typ: | IAzureContextContainer |
Aliasy: | AzContext, AzureRmContext, AzureCredential |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-DirectoryPath
Katalog, w którym zostanie przeprowadzone wykrywanie zmian.
Typ: | String |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | True |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-InputObject
Obiekt CloudEndpoint, zwykle przekazywany przez parametr .
Typ: | PSCloudEndpoint |
Aliasy: | CloudEndpoint |
Position: | 0 |
Domyślna wartość: | None |
Wymagane: | True |
Akceptowanie danych wejściowych potoku: | True |
Akceptowanie symboli wieloznacznych: | False |
-Name
Nazwa punktu końcowego CloudEndpoint. Nazwa jest identyfikatorem GUID, a nie przyjazną nazwą wyświetlaną w portalu. Aby uzyskać nazwę CloudEndpointName, użyj polecenia cmdlet Get-AzStorageSyncCloudEndpoint.
Typ: | String |
Aliasy: | CloudEndpointName |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | True |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-PassThru
W normalnym wykonaniu to polecenie cmdlet nie zwraca żadnej wartości dla powodzenia. Jeśli podasz parametr PassThru, polecenie cmdlet zapisze wartość w potoku po pomyślnym wykonaniu.
Typ: | SwitchParameter |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-Path
Ścieżka, w której zostanie przeprowadzone wykrywanie zmian.
Typ: | String[] |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | True |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-Recursive
Wskazuje, czy wykrywanie zmian katalogu jest rekursywne.
Typ: | SwitchParameter |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-ResourceGroupName
Nazwa grupy zasobów.
Typ: | String |
Position: | 0 |
Domyślna wartość: | None |
Wymagane: | True |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-ResourceId
Identyfikator zasobu cloudEndpoint
Typ: | String |
Aliasy: | CloudEndpointId |
Position: | 0 |
Domyślna wartość: | None |
Wymagane: | True |
Akceptowanie danych wejściowych potoku: | True |
Akceptowanie symboli wieloznacznych: | False |
-StorageSyncServiceName
Nazwa usługi StorageSyncService.
Typ: | String |
Aliasy: | ParentName |
Position: | 1 |
Domyślna wartość: | None |
Wymagane: | True |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-SyncGroupName
Nazwa grupy synchronizacji.
Typ: | String |
Position: | 2 |
Domyślna wartość: | None |
Wymagane: | True |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-WhatIf
Pokazuje, co się stanie po uruchomieniu polecenia cmdlet. Polecenie cmdlet nie zostało uruchomione.
Typ: | SwitchParameter |
Aliasy: | wi |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |