Udostępnij za pośrednictwem


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

Dane wejściowe

String

PSServerEndpoint

Dane wyjściowe

Void