Delen via


Invoke-AzStorageSyncChangeDetection

Met deze opdracht kunt u handmatig de detectie van naamruimtewijzigingen initiëren. Deze kan worden gericht op de volledige share, submap of set bestanden. Wanneer u de opdracht uitvoert met de parameters -DirectoryPath of -Path, kunnen maximaal 10.000 items worden gedetecteerd. Als u het bereik van wijzigingen kent, beperkt u de uitvoering van deze opdracht tot onderdelen van de naamruimte, zodat wijzigingsdetectie snel en binnen de limiet van 10.000 items kan worden voltooid. U kunt ook de itemlimiet vermijden door de cmdlet uit te voeren zonder deze parameters, waardoor wijzigingsdetectie op shareniveau wordt aanroept.

Notitie

Als deze wordt uitgevoerd met de parameters -DirectoryPath of -Path, detecteert de opdracht niet de volgende wijzigingen in de Azure-bestandsshare:

  • Bestanden die worden verwijderd.
  • Bestanden die uit de share worden verplaatst.
  • Bestanden die zijn verwijderd en gemaakt met dezelfde naam.

Als wijzigingsdetectie op shareniveau wordt aangeroepen, worden al deze wijzigingen gedetecteerd. Deze wijzigingen worden ook gedetecteerd wanneer de geplande wijzigingsdetectietaak wordt uitgevoerd.

Syntaxis

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

Description

Periodiek controleert Azure File Sync de naamruimte in een synchroniserende Azure-bestandsshare op wijzigingen die op een andere manier in de bestandsshare zijn gekomen dan synchroniseren. Het doel is om deze wijzigingen te identificeren en ze uiteindelijk te synchroniseren met verbonden servers. Met deze opdracht kunt u handmatig de detectie van naamruimtenwijzigingen initiëren. Deze kan worden gericht op de volledige share, submap of set bestanden. Als u het bereik van wijzigingen kent, beperkt u de uitvoering van deze opdracht tot delen van de naamruimte, zodat de detectie van afzonderlijke items snel en binnen de limiet van 10.000 items kan worden voltooid. Voer anders de opdracht uit zonder de parameters -DirectoryPath of -Path om volledige detectie van wijzigingen op shareniveau aan te roepen. De cmdlet Invoke-AzStorageSyncChangeDetection annuleert een opsommingstaak voor cloudwijziging die wordt uitgevoerd. Als u wilt voorkomen dat een actieve taak wordt geannuleerd, gaat u naar de eigenschappen van het cloudeindpunt in de portal om te controleren of een taak momenteel wordt uitgevoerd.

Voorbeelden

Voorbeeld 1

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

In dit voorbeeld wordt wijzigingsdetectie uitgevoerd in de mappen 'Gegevens' en 'Rapportage\Sjablonen' van een synchronisatie van een Azure-bestandsshare. Alle paden zijn relatief ten opzichte van de hoofdmap van de Azure-bestandssharenaamruimte.

Voorbeeld 2

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

In dit voorbeeld wordt wijzigingsdetectie uitgevoerd voor een set bestanden die bekend zijn bij de aanroeper van de opdracht die moet zijn gewijzigd. Het doel is om azure-bestandssynchronisatie deze wijzigingen te laten detecteren en synchroniseren.

Voorbeeld 3

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

In dit voorbeeld wordt wijzigingsdetectie uitgevoerd voor de map 'Voorbeelden' en worden wijzigingen recursief gedetecteerd in submappen. Houd er rekening mee dat de cmdlet mislukt als het pad meer dan 10.000 items bevat. Als het pad meer dan 10.000 items bevat, voert u de opdracht uit op subonderdelen van de naamruimte.

Voorbeeld 4

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

In dit voorbeeld is -DirectoryPath of -Path niet doorgegeven aan de opdracht. Hiermee wordt wijzigingsdetectie aangeroepen voor de hele bestandsshare.

Parameters

-AsJob

Cmdlet op de achtergrond uitvoeren

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Confirm

Hiermee wordt u gevraagd om bevestiging voordat u de cmdlet uitvoert.

Type:SwitchParameter
Aliassen:cf
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-DefaultProfile

De referenties, accounts, tenants en abonnementen die worden gebruikt voor communicatie met Azure.

Type:IAzureContextContainer
Aliassen:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-DirectoryPath

Map waarin wijzigingsdetectie wordt uitgevoerd.

Type:String
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-InputObject

CloudEndpoint-object, normaal gesproken doorgegeven via de parameter.

Type:PSCloudEndpoint
Aliassen:CloudEndpoint
Position:0
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-Name

Naam van het CloudEndpoint. De naam is een GUID, niet de beschrijvende naam die wordt weergegeven in de portal. Gebruik de cmdlet Get-AzStorageSyncCloudEndpoint om de CloudEndpointName op te halen.

Type:String
Aliassen:CloudEndpointName
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-PassThru

Bij normale uitvoering retourneert deze cmdlet geen waarde voor succes. Als u de parameter PassThru opgeeft, schrijft de cmdlet na een geslaagde uitvoering een waarde naar de pijplijn.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Path

Pad waar wijzigingsdetectie wordt uitgevoerd.

Type:String[]
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Recursive

Geeft aan of de detectie van adreslijstwijziging recursief is.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-ResourceGroupName

Naam resourcegroep.

Type:String
Position:0
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-ResourceId

CloudEndpoint-resource-id

Type:String
Aliassen:CloudEndpointId
Position:0
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-StorageSyncServiceName

De naam van de StorageSyncService.

Type:String
Aliassen:ParentName
Position:1
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-SyncGroupName

Naam van de SyncGroup.

Type:String
Position:2
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-WhatIf

Hiermee wordt weergegeven wat er zou gebeuren als u de cmdlet uitvoert. De cmdlet wordt niet uitgevoerd.

Type:SwitchParameter
Aliassen:wi
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

Invoerwaarden

String

PSServerEndpoint

Uitvoerwaarden

Void