Share via


Invoke-AzStorageSyncChangeDetection

Questo comando può essere usato per avviare manualmente il rilevamento delle modifiche dello spazio dei nomi. Può essere destinato all'intera condivisione, alla sottocartella o al set di file. Quando si esegue il comando con i parametri -DirectoryPath o -Path, è possibile rilevare un massimo di 10.000 elementi. Se l'ambito delle modifiche è noto all'utente, limitare l'esecuzione di questo comando a parti dello spazio dei nomi, in modo che il rilevamento delle modifiche possa terminare rapidamente e entro il limite di 10.000 elementi. In alternativa, è possibile evitare il limite di elementi eseguendo il cmdlet senza questi parametri, richiamando il rilevamento delle modifiche a livello di condivisione.

Nota

Se eseguito con i parametri -DirectoryPath o -Path, il comando non rileverà le modifiche seguenti nella condivisione file di Azure:

  • File eliminati.
  • File spostati dalla condivisione.
  • File eliminati e creati con lo stesso nome.

Se viene richiamato il rilevamento delle modifiche a livello di condivisione, verranno rilevate tutte queste modifiche. Queste modifiche verranno rilevate anche quando viene eseguito il processo di rilevamento delle modifiche pianificato.

Sintassi

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>]

Descrizione

Periodicamente, Sincronizzazione file di Azure controlla lo spazio dei nomi all'interno di una condivisione file di Azure sincronizzata per verificare la presenza di modifiche apportate alla condivisione file in modo diverso dalla sincronizzazione. L'obiettivo è identificare queste modifiche e infine sincronizzarle con i server connessi. Questo comando può essere usato per avviare manualmente il rilevamento delle modifiche degli spazi dei nomi. Può essere destinato all'intera condivisione, alla sottocartella o al set di file. Se l'ambito delle modifiche è noto all'utente, limitare l'esecuzione di questo comando a parti dello spazio dei nomi, in modo che il rilevamento delle modifiche dei singoli elementi possa terminare rapidamente e entro il limite di 10.000 elementi. In caso contrario, eseguire il comando senza i parametri -DirectoryPath o -Path per richiamare il rilevamento completo delle modifiche a livello di condivisione. Il cmdlet Invoke-Az Archiviazione SyncChangeDetection annulla un processo di enumerazione delle modifiche cloud in corso. Per evitare di annullare un processo attualmente in esecuzione, passare alle proprietà dell'endpoint cloud nel portale per verificare se un processo è attualmente in esecuzione.

Esempio

Esempio 1

Invoke-AzStorageSyncChangeDetection -ResourceGroupName "myResourceGroup" -StorageSyncServiceName "myStorageSyncServiceName" -SyncGroupName "mySyncGroupName" -CloudEndpointName "b38fc242-8100-4807-89d0-399cef5863bf" -Path "Data","Reporting\Templates"

In questo esempio, il rilevamento delle modifiche viene eseguito nelle directory "Dati" e "Reporting\Templates" di una condivisione file di Azure sincronizzata. Tutti i percorsi sono relativi alla radice dello spazio dei nomi della condivisione file di Azure.

Esempio 2

Invoke-AzStorageSyncChangeDetection -ResourceGroupName "myResourceGroup" -StorageSyncServiceName "myStorageSyncServiceName" -SyncGroupName "mySyncGroupName" -CloudEndpointName "b38fc242-8100-4807-89d0-399cef5863bf" -Path "Data\results.xslx","Reporting\Templates\generated.pptx"

In questo esempio viene eseguito il rilevamento delle modifiche per un set di file noti al chiamante del comando da modificare. L'obiettivo è quello di rilevare e sincronizzare queste modifiche anche in Sincronizzazione file di Azure.

Esempio 3

Invoke-AzStorageSyncChangeDetection -ResourceGroupName "myResourceGroup" -StorageSyncServiceName "myStorageSyncServiceName" -SyncGroupName "mySyncGroupName" -CloudEndpointName "b38fc242-8100-4807-89d0-399cef5863bf" -DirectoryPath "Examples" -Recursive

In questo esempio, il rilevamento delle modifiche viene eseguito per la directory "Esempi" e rileverà in modo ricorsivo le modifiche nelle sottodirectory. Tenere presente che il cmdlet avrà esito negativo se il percorso contiene più di 10.000 elementi. Se il percorso contiene più di 10.000 elementi, eseguire il comando in parti secondarie dello spazio dei nomi.

Esempio 4

Invoke-AzStorageSyncChangeDetection -ResourceGroupName "myResourceGroup" -StorageSyncServiceName "myStorageSyncServiceName" -SyncGroupName "mySyncGroupName" -CloudEndpointName "b38fc242-8100-4807-89d0-399cef5863bf"

In questo esempio non è stato passato al comando né -DirectoryPath né -Path. Verrà richiamato il rilevamento delle modifiche nell'intera condivisione file.

Parametri

-AsJob

Eseguire il cmdlet in background

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

-Confirm

Richiede conferma prima di eseguire il cmdlet.

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

-DefaultProfile

Le credenziali, l’account, il tenant e la sottoscrizione usati per comunicare con Azure.

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

-DirectoryPath

Directory in cui verrà eseguito il rilevamento delle modifiche.

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

-InputObject

Oggetto CloudEndpoint, in genere passato tramite il parametro .

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

-Name

Nome di CloudEndpoint. Il nome è un GUID, non il nome descrittivo visualizzato nel portale. Per ottenere CloudEndpointName, usare il cmdlet Get-Az Archiviazione SyncCloudEndpoint.

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

-PassThru

Nell'esecuzione normale, questo cmdlet non restituisce alcun valore in caso di esito positivo. Se si specifica il parametro PassThru, il cmdlet scriverà un valore nella pipeline dopo l'esecuzione corretta.

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

-Path

Percorso in cui verrà eseguito il rilevamento delle modifiche.

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

-Recursive

Indica se il rilevamento delle modifiche della directory è ricorsivo.

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

-ResourceGroupName

Nome del gruppo di risorse.

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

-ResourceId

ID risorsa CloudEndpoint

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

-StorageSyncServiceName

Nome del Archiviazione SyncService.

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

-SyncGroupName

Nome del gruppo di sincronizzazione.

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

-WhatIf

Mostra gli effetti dell'esecuzione del cmdlet. Il cmdlet non viene eseguito.

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

Input

String

PSServerEndpoint

Output

Void