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>]
      [-ProgressAction <ActionPreference>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Invoke-AzStorageSyncChangeDetection
      [-ResourceGroupName] <String>
      [-StorageSyncServiceName] <String>
      [-SyncGroupName] <String>
      -Name <String>
      -DirectoryPath <String>
      [-Recursive]
      [-PassThru]
      [-AsJob]
      [-DefaultProfile <IAzureContextContainer>]
      [-ProgressAction <ActionPreference>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Invoke-AzStorageSyncChangeDetection
      [-ResourceGroupName] <String>
      [-StorageSyncServiceName] <String>
      [-SyncGroupName] <String>
      -Name <String>
      -Path <String[]>
      [-PassThru]
      [-AsJob]
      [-DefaultProfile <IAzureContextContainer>]
      [-ProgressAction <ActionPreference>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Invoke-AzStorageSyncChangeDetection
      [-ResourceId] <String>
      -DirectoryPath <String>
      [-Recursive]
      [-PassThru]
      [-AsJob]
      [-DefaultProfile <IAzureContextContainer>]
      [-ProgressAction <ActionPreference>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Invoke-AzStorageSyncChangeDetection
      [-ResourceId] <String>
      -Path <String[]>
      [-PassThru]
      [-AsJob]
      [-DefaultProfile <IAzureContextContainer>]
      [-ProgressAction <ActionPreference>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Invoke-AzStorageSyncChangeDetection
      [-ResourceId] <String>
      [-PassThru]
      [-AsJob]
      [-DefaultProfile <IAzureContextContainer>]
      [-ProgressAction <ActionPreference>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Invoke-AzStorageSyncChangeDetection
      [-InputObject] <PSCloudEndpoint>
      -DirectoryPath <String>
      [-Recursive]
      [-PassThru]
      [-AsJob]
      [-DefaultProfile <IAzureContextContainer>]
      [-ProgressAction <ActionPreference>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Invoke-AzStorageSyncChangeDetection
      [-InputObject] <PSCloudEndpoint>
      -Path <String[]>
      [-PassThru]
      [-AsJob]
      [-DefaultProfile <IAzureContextContainer>]
      [-ProgressAction <ActionPreference>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Invoke-AzStorageSyncChangeDetection
      [-InputObject] <PSCloudEndpoint>
      [-PassThru]
      [-AsJob]
      [-DefaultProfile <IAzureContextContainer>]
      [-ProgressAction <ActionPreference>]
      [-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

Typ:	SwitchParameter
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-Confirm

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

Typ:	SwitchParameter
Aliase:	cf
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-DefaultProfile

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

Typ:	IAzureContextContainer
Aliase:	AzContext, AzureRmContext, AzureCredential
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-DirectoryPath

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

Typ:	String
Position:	Named
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-InputObject

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

Typ:	PSCloudEndpoint
Aliase:	CloudEndpoint
Position:	0
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	True
Platzhalterzeichen akzeptieren:	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".

Typ:	String
Aliase:	CloudEndpointName
Position:	Named
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	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.

Typ:	SwitchParameter
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-Path

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

Typ:	String[]
Position:	Named
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-ProgressAction

Typ:	ActionPreference
Aliase:	proga
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-Recursive

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

Typ:	SwitchParameter
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-ResourceGroupName

Ressourcengruppenname.

Typ:	String
Position:	0
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-ResourceId

CloudEndpoint-Ressourcen-ID

Typ:	String
Aliase:	CloudEndpointId
Position:	0
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	True
Platzhalterzeichen akzeptieren:	False

-StorageSyncServiceName

Name des StorageSyncService.

Typ:	String
Aliase:	ParentName
Position:	1
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-SyncGroupName

Name der SyncGroup.

Typ:	String
Position:	2
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-WhatIf

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

Typ:	SwitchParameter
Aliase:	wi
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

Eingaben

String

PSServerEndpoint

Ausgaben

Void

Freigeben über