Clear-Content
Usuwa zawartość elementu, ale nie usuwa elementu.
Składnia
Clear-Content
[-Path] <String[]>
[-Filter <String>]
[-Include <String[]>]
[-Exclude <String[]>]
[-Force]
[-Credential <PSCredential>]
[-WhatIf]
[-Confirm]
[-Stream <String>]
[<CommonParameters>]
Clear-Content
-LiteralPath <String[]>
[-Filter <String>]
[-Include <String[]>]
[-Exclude <String[]>]
[-Force]
[-Credential <PSCredential>]
[-WhatIf]
[-Confirm]
[-Stream <String>]
[<CommonParameters>]
Opis
Polecenie Clear-Content
cmdlet usuwa zawartość elementu, na przykład usunięcie tekstu z pliku, ale nie powoduje usunięcia elementu. W związku z tym element istnieje, ale jest pusty. Clear-Content
jest podobny do Clear-Item
elementu , ale działa w przypadku elementów z zawartością, a nie elementów z wartościami.
Przykłady
Przykład 1. Usuwanie całej zawartości z katalogu
Clear-Content "..\SmpUsers\*\init.txt"
To polecenie usuwa całą zawartość z init.txt
plików we wszystkich podkatalogach SmpUsers
katalogu. Pliki nie są usuwane, ale są puste.
Przykład 2. Usuwanie zawartości wszystkich plików z symbolem wieloznacznymi
Clear-Content -Path "*" -Filter "*.log" -Force
To polecenie usuwa zawartość wszystkich plików w bieżącym katalogu z .log
rozszerzeniem nazwy pliku, w tym pliki z atrybutem tylko do odczytu. Gwiazdka (*
) w ścieżce reprezentuje wszystkie elementy w bieżącym katalogu. Parametr Force sprawia, że polecenie jest skuteczne w plikach tylko do odczytu. Użycie filtru w celu ograniczenia polecenia do plików z .log
rozszerzeniem nazwy pliku zamiast określania *.log
w ścieżce sprawia, że operacja jest szybsza.
Przykład 3. Czyszczenie wszystkich danych ze strumienia
W tym przykładzie Clear-Content
pokazano, jak polecenie cmdlet czyści zawartość z alternatywnego strumienia danych, pozostawiając strumień nienaruszony.
Pierwsze polecenie używa Get-Content
polecenia cmdlet , aby pobrać zawartość Zone.Identifier
strumienia w Copy-Script.ps1
pliku, który został pobrany z Internetu.
Drugie polecenie używa Clear-Content
polecenia cmdlet do wyczyszczenia zawartości.
Trzecie polecenie powtarza pierwsze polecenie. Sprawdza, czy zawartość jest czyszczone, ale strumień pozostaje. Jeśli strumień został usunięty, polecenie spowoduje wygenerowanie błędu.
Możesz użyć metody podobnej do tej, aby wyczyścić zawartość alternatywnego strumienia danych. Jednak nie jest to zalecany sposób wyeliminowania kontroli zabezpieczeń, które blokują pliki pobierane z Internetu. Jeśli sprawdzisz, czy pobrany plik jest bezpieczny, użyj Unblock-File
polecenia cmdlet .
Get-Content C:\Test\Copy-Script.ps1 -Stream Zone.Identifier
[ZoneTransfer]
ZoneId=3
Clear-Content C:\Test\Copy-Script.ps1 -Stream Zone.Identifier
Get-Content C:\Test\Copy-Script.ps1 -Stream Zone.Identifier
Parametry
-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 |
-Credential
Uwaga
Ten parametr nie jest obsługiwany przez żadnych dostawców zainstalowanych w programie PowerShell. Aby personifikować innego użytkownika lub podnieść poziom poświadczeń podczas uruchamiania tego polecenia cmdlet, użyj polecenia Invoke-Command
.
Type: | PSCredential |
Position: | Named |
Default value: | Current user |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Exclude
Określa jako tablicę ciągów, które to polecenie cmdlet pomija ze ścieżki do zawartości. Wartość tego parametru kwalifikuje parametr Path . Wprowadź element ścieżki lub wzorzec, taki jak *.txt
. Dozwolone są symbole wieloznaczne.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | True |
-Filter
Określa filtr w formacie lub języku dostawcy. Wartość tego parametru kwalifikuje parametr Path . Składnia filtru, w tym użycie symboli wieloznacznych, zależy od dostawcy. Filtry są bardziej wydajne niż inne parametry, ponieważ dostawca stosuje je podczas pobierania obiektów, zamiast filtrowania obiektów za pomocą programu PowerShell po ich pobraniu.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | True |
-Force
Wymusza uruchomienie polecenia bez monitowania o potwierdzenie użytkownika.
Type: | SwitchParameter |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Include
Określa jako tablicę ciągów zawartość, którą to polecenie cmdlet czyści. Wartość tego parametru kwalifikuje parametr Path . Wprowadź element ścieżki lub wzorzec, taki jak *.txt
. Dozwolone są symbole wieloznaczne.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | True |
-LiteralPath
Określa ścieżki do elementów, z których zawartość jest usuwana. W przeciwieństwie do parametru Path wartość LiterałuPath jest używana dokładnie tak, jak jest typowana. Znaki nie są interpretowane jako symbole wieloznaczne.
Jeśli ścieżka zawiera znaki ucieczki, należy ująć ją w znaki pojedynczego cudzysłowu ('
). Znaki pojedynczego cudzysłowu informują, że program PowerShell nie interpretuje żadnych znaków jako sekwencji ucieczki.
Type: | String[] |
Aliases: | PSPath, LP |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Path
Określa ścieżki do elementów, z których zawartość jest usuwana. Dozwolone są symbole wieloznaczne. Ścieżki muszą być ścieżkami do elementów, a nie do kontenerów. Na przykład należy określić ścieżkę do co najmniej jednego pliku, a nie ścieżkę do katalogu. Dozwolone są symbole wieloznaczne. Ten parametr jest wymagany, ale nazwa parametru (ścieżka) jest opcjonalna.
Type: | String[] |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | True |
-Stream
Uwaga
Ten parametr jest dostępny tylko w systemie Windows.
Określa alternatywny strumień danych dla zawartości. Jeśli strumień nie istnieje, to polecenie cmdlet go utworzy. Symbole wieloznaczne nie są obsługiwane.
Stream jest parametrem dynamicznym dodawanym przez dostawcę systemu plików do elementu Clear-Content
. Ten parametr działa tylko na dyskach systemu plików i czyści zawartość alternatywnych strumieni danych w plikach i katalogach.
Możesz użyć Clear-Content
polecenia cmdlet , aby zmienić zawartość dowolnego alternatywnego strumienia danych, takiego jak Zone.Identifier
. Nie zalecamy jednak tego jako sposobu na wyeliminowanie kontroli zabezpieczeń blokujących pliki pobierane z Internetu. Jeśli sprawdzisz, czy pobrany plik jest bezpieczny, użyj Unblock-File
polecenia cmdlet .
Ten parametr został wprowadzony w programie PowerShell 3.0.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
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: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Dane wejściowe
None
Nie można potokować obiektów do obiektu Clear-Content
.
Dane wyjściowe
None
To polecenie cmdlet nie zwraca żadnych obiektów.
Uwagi
Można używać Clear-Content
z dostawcą systemu plików programu PowerShell i z innymi dostawcami, którzy manipulują zawartością. Aby wyczyścić elementy, które nie są uważane za zawartość, takie jak elementy zarządzane przez dostawcę certyfikatu programu PowerShell lub rejestru, użyj polecenia Clear-Item
.
Polecenie Clear-Content
cmdlet jest przeznaczone do pracy z danymi udostępnianymi przez dowolnego dostawcę.
Aby wyświetlić listę dostawców dostępnych w sesji, wpisz Get-PsProvider
.
Aby uzyskać więcej informacji, zobacz about_Providers.