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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

Poświadczenia, konto, dzierżawa i subskrypcja używane do komunikacji z platformą Azure.

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DirectoryPath

Katalog, w którym zostanie przeprowadzone wykrywanie zmian.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-InputObject

Obiekt CloudEndpoint, zwykle przekazywany przez parametr .

Type:PSCloudEndpoint
Aliases:CloudEndpoint
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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.

Type:String
Aliases:CloudEndpointName
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters: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.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Path

Ścieżka, w której zostanie przeprowadzone wykrywanie zmian.

Type:String[]
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Recursive

Wskazuje, czy wykrywanie zmian katalogu jest rekursywne.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ResourceGroupName

Nazwa grupy zasobów.

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-ResourceId

Identyfikator zasobu cloudEndpoint

Type:String
Aliases:CloudEndpointId
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-StorageSyncServiceName

Nazwa usługi StorageSyncService.

Type:String
Aliases:ParentName
Position:1
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-SyncGroupName

Nazwa grupy synchronizacji.

Type:String
Position:2
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Pokazuje, co się stanie po uruchomieniu polecenia cmdlet. Polecenie cmdlet nie zostało uruchomione.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Dane wejściowe

String

PSServerEndpoint

Dane wyjściowe

Void