Invoke-AzStorageSyncChangeDetection

Referenz

Modul:: Az.StorageSync

Dieser Befehl kann verwendet werden, um die Erkennung von Namespaceänderungen manuell zu initiieren. Sie kann auf die gesamte Freigabe, den Unterordner oder die Gruppe von Dateien ausgerichtet werden. Wenn Sie den Befehl mit den Parametern "-DirectoryPath" oder "-Path" ausführen, können maximal 10.000 Elemente erkannt werden. Wenn ihnen der Umfang der Änderungen bekannt ist, beschränken Sie die Ausführung dieses Befehls auf Teile des Namespace, sodass die Änderungserkennung schnell und innerhalb des Grenzwerts von 10.000 Elementen abgeschlossen werden kann. Alternativ können Sie das Elementlimit vermeiden, indem Sie das Cmdlet ohne diese Parameter ausführen und die Erkennung von Änderungen auf Freigabeebene aufrufen.

Hinweis

Wenn sie mit Parametern "-DirectoryPath" oder "-Path" ausgeführt werden, erkennt der Befehl nicht die folgenden Änderungen in der Azure-Dateifreigabe:

Dateien, die gelöscht werden.
Dateien, die aus der Freigabe verschoben werden.
Dateien, die gelöscht und mit demselben Namen erstellt werden.

Wenn die Erkennung von Änderungen auf Freigabeebene aufgerufen wird, werden alle diese Änderungen erkannt. Diese Änderungen werden auch erkannt, wenn der geplante Änderungserkennungsauftrag ausgeführt wird.

Syntax

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

Beschreibung

In regelmäßigen Abständen überprüft Azure-Dateisynchronisierung den Namespace in einer synchronisierten Azure-Dateifreigabe auf Änderungen, die auf andere Weise als Synchronisierung in die Dateifreigabe gelangt sind. Ziel ist es, diese Änderungen zu identifizieren und letztendlich mit verbundenen Servern zu synchronisieren. Dieser Befehl kann verwendet werden, um die Erkennung von Namespaceänderungen manuell zu initiieren. Sie kann auf die gesamte Freigabe, den Unterordner oder die Gruppe von Dateien ausgerichtet werden. Wenn ihnen der Umfang der Änderungen bekannt ist, beschränken Sie die Ausführung dieses Befehls auf Teile des Namespace, sodass die Erkennung einzelner Elemente schnell und innerhalb des Grenzwerts von 10.000 Elementen abgeschlossen werden kann. Führen Sie andernfalls den Befehl ohne die Parameter "-DirectoryPath" oder "-Path" aus, um die vollständige Änderungserkennung auf Freigabeebene aufzurufen. Das Cmdlet Invoke-AzStorageSyncChangeDetection bricht einen In-Cloud-Enumerationsauftrag ab, der ausgeführt wird. Um zu vermeiden, dass ein aktuell ausgeführter Auftrag abgebrochen wird, wechseln Sie zu den Cloud-Endpunkt-Eigenschaften im Portal, um zu überprüfen, ob ein Auftrag derzeit ausgeführt wird.

Beispiele

Beispiel 1

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

In diesem Beispiel wird die Änderungserkennung in den Verzeichnissen "Daten" und "Reporting\Templates" einer synchronisierten Azure-Dateifreigabe ausgeführt. Alle Pfade sind relativ zum Stamm des Azure-Dateifreigabenamespaces.

Beispiel 2

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

In diesem Beispiel wird die Änderungserkennung für eine Reihe von Dateien ausgeführt, die dem Befehlsaufrufer bekannt sind, der geändert wurde. Ziel ist es, die Azure-Dateisynchronisierung auch zu erkennen und zu synchronisieren.

Beispiel 3

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

In diesem Beispiel wird die Änderungserkennung für das Verzeichnis "Examples" ausgeführt und erkennt rekursiv Änderungen in Unterverzeichnissen. Denken Sie daran, dass das Cmdlet fehlschlägt, wenn der Pfad mehr als 10.000 Elemente enthält. Wenn der Pfad mehr als 10.000 Elemente enthält, führen Sie den Befehl in Unterteilen des Namespaces aus.

Beispiel 4

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

In diesem Beispiel wurde weder -DirectoryPath noch -Path an den Befehl übergeben. Dadurch wird die Änderungserkennung für die gesamte Dateifreigabe aufgerufen.

Parameter

-AsJob

Cmdlet im Hintergrund ausführen

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

-Confirm

Hiermit werden Sie vor der Ausführung des Cmdlets zur Bestätigung aufgefordert.

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

-DefaultProfile

Anmeldeinformationen, Konto, Mandant und Abonnement für die Kommunikation mit Azure

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

-DirectoryPath

Verzeichnis, in dem die Änderungserkennung durchgeführt wird.

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

-InputObject

CloudEndpoint-Objekt, normalerweise über den Parameter übergeben.

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

-Name

Name des CloudEndpoint. Der Name ist eine GUID, nicht der Anzeigename, der im Portal angezeigt wird. Verwenden Sie zum Abrufen des CloudEndpointName-Cmdlets das Cmdlet "Get-AzStorageSyncCloudEndpoint".

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

-PassThru

In normaler Ausführung gibt dieses Cmdlet keinen Wert für erfolglos zurück. Wenn Sie den PassThru-Parameter angeben, schreibt das Cmdlet nach erfolgreicher Ausführung einen Wert in die Pipeline.

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

-Path

Pfad, in dem die Änderungserkennung durchgeführt wird.

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

-Recursive

Gibt an, ob die Erkennung von Verzeichnisänderungen rekursiv ist.

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

-ResourceGroupName

Ressourcengruppenname.

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

-ResourceId

CloudEndpoint-Ressourcen-ID

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

-StorageSyncServiceName

Name des StorageSyncService.

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

-SyncGroupName

Name der SyncGroup.

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

-WhatIf

Zeigt, was geschieht, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

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

Eingaben

String

PSServerEndpoint

Ausgaben

Void