Unprotect-CmsMessage

Modül:

Microsoft.PowerShell.Security Module

Şifreleme İletisi Söz Dizimi biçimi kullanılarak şifrelenen içeriğin şifresini çözer.

Sözdizimi

ByWinEvent EnterprisePublishing

Unprotect-CmsMessage
    [-EventLogRecord] <EventLogRecord>
    [[-To] <CmsMessageRecipient[]>]
    [-IncludeContext]
    [<CommonParameters>]

ByContent

Unprotect-CmsMessage
    [-Content] <string>
    [[-To] <CmsMessageRecipient[]>]
    [-IncludeContext]
    [<CommonParameters>]

ByPath

Unprotect-CmsMessage
    [-Path] <string>
    [[-To] <CmsMessageRecipient[]>]
    [-IncludeContext]
    [<CommonParameters>]

ByLiteralPath

Unprotect-CmsMessage
    [-LiteralPath] <string>
    [[-To] <CmsMessageRecipient[]>]
    [-IncludeContext]
    [<CommonParameters>]

Description

Unprotect-CmsMessage cmdlet'i, Şifreleme İletisi Söz Dizimi (CMS) biçimi kullanılarak şifrelenmiş içeriğin şifresini çözer.

CMS cmdlet'leri, RFC5652tarafından belgelendiği gibi iletileri şifrelemek için IETF standart biçimini kullanarak içeriğin şifrelenmesini ve şifre çözmesini destekler.

CMS şifreleme standardı, içeriği şifrelemek için kullanılan anahtarların (ortak anahtar) ve içeriğin şifresini çözmek için kullanılan anahtarların (özel anahtar) ayrı olduğu ortak anahtar şifrelemesini kullanır. Ortak anahtarınız yaygın olarak paylaşılabilir ve hassas veriler değildir. Herhangi bir içerik bu ortak anahtarla şifrelenirse, yalnızca özel anahtarınız şifreyi çözebilir. Daha fazla bilgi için bkz. ortak anahtar şifreleme.

Unprotect-CmsMessage, CMS biçiminde şifrelenmiş içeriğin şifresini çözer. Protect-CmsMessage cmdlet'ini çalıştırarak şifrelediğiniz içeriğin şifresini çözmek için bu cmdlet'i çalıştırabilirsiniz. Şifrelerini çözmek istediğiniz içeriği dize olarak, şifreleme olay günlüğü kayıt kimliği numarasına veya şifrelenmiş içeriğin yoluna göre belirtebilirsiniz. Unprotect-CmsMessage cmdlet şifre çözülmüş içeriği geri döndürür.

PowerShell 7.1'de Linux ve macOS desteği eklendi.

Örnekler

Örnek 1: İletinin şifresini çözme

Aşağıdaki örnekte, C:\Users\Test\Documents\PowerShellsabit yolunda bulunan içeriğin şifresini çözersiniz. Gerekli to parametresinin değeri için, bu örnekte şifrelemeyi gerçekleştirmek için kullanılan sertifikanın parmak izi kullanılır. Şifresi çözülen ileti, "Yeni Tümünü Kes komutunu deneyin," olarak sonuçlanır.

$parameters = @{
  LiteralPath = "C:\Users\Test\Documents\PowerShell\Future_Plans.txt"
  To = '0f 8j b1 ab e0 ce 35 1d 67 d2 f2 6f a2 d2 00 cl 22 z9 m9 85'
}
Unprotect-CmsMessage -LiteralPath @parameters

Try the new Break All command

Örnek 2: Şifrelenmiş olay günlüğü iletisinin şifresini çözme

Aşağıdaki örnek, PowerShell olay günlüğünden şifrelenmiş bir olay alır ve Unprotect-CmsMessagekullanarak şifresini çözer.

$event = Get-WinEvent Microsoft-Windows-PowerShell/Operational -MaxEvents 1 |
    Where-Object Id -EQ 4104
Unprotect-CmsMessage -EventLogRecord $event

Örnek 3: İşlem hattını kullanarak şifrelenmiş olay günlüğü iletilerinin şifresini çözme

Aşağıdaki örnek, PowerShell olay günlüğünden tüm şifrelenmiş olayları alır ve Unprotect-CmsMessagekullanarak bunların şifresini çözer.

Get-WinEvent Microsoft-Windows-PowerShell/Operational |
    Where-Object Id -EQ 4104 |
    Unprotect-CmsMessage

Parametreler

-Content

Şifrelenmiş bir dizeyi veya şifrelenmiş dize içeren bir değişkeni belirtir.

Parametre özellikleri

Tür:	String
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

ByContent

Position:	0
Zorunlu:	True
İşlem hattından gelen değer:	True
Özellik adına göre işlem hattından gelen değer:	True
Kalan bağımsız değişkenlerden elde edilen değer:	False

-EventLogRecord

CMS şifreli iletisi içeren bir olay günlüğü kaydı belirtir.

Parametre özellikleri

Tür:	PSObject
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

ByWinEvent

Position:	0
Zorunlu:	True
İşlem hattından gelen değer:	True
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-IncludeContext

Yalnızca şifresi çözülmüş içeriğin çıkışını vermek yerine, şifresi çözülen içeriğin özgün bağlamında eklenip eklenmeyeceğini belirler.

Parametre özellikleri

Tür:	SwitchParameter
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-LiteralPath

Şifresini çözmek istediğiniz şifrelenmiş içeriğin yolunu belirtir. Path'in aksine, LiteralPath değeri tam olarak yazıldığı gibi kullanılır. Hiçbir karakter joker karakter olarak yorumlanmamıştır. Yol kaçış karakterleri içeriyorsa, yolu tek tırnak işaretleriyle çevreleyin. Tek tırnak işaretleri, PowerShell'in hiçbir karakteri kaçış dizisi olarak yorumlamamasını sağlar.

Parametre özellikleri

Tür:	String
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

ByLiteralPath

Position:	0
Zorunlu:	True
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-Path

Şifresini çözmek istediğiniz şifrelenmiş içeriğin yolunu belirtir.

Parametre özellikleri

Tür:	String
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

ByPath

Position:	0
Zorunlu:	True
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-To

Aşağıdaki biçimlerden herhangi birinde tanımlanan bir veya daha fazla CMS ileti alıcısını belirtir:

• Gerçek bir sertifika (Sertifika sağlayıcısından alınan şekilde).
• Sertifikayı içeren dosyanın yolu.
• Sertifika içeren dizinin yolu.
• Sertifikanın parmak izi (sertifika deposunda arama yapmak için kullanılır).
• Sertifikanın konu adı (sertifika mağazasında arama yapmak için kullanılır).

Parametre özellikleri

Tür:	CmsMessageRecipient[]
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	1
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

CommonParameters

Bu cmdlet yaygın parametreleri destekler: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction ve -WarningVariable. Daha fazla bilgi için bkz. about_CommonParameters.

Girişler

EventLogRecord

String

Şifrelenmiş içerik içeren bir nesneyi bu cmdlet'e yöneltebilirsiniz.

Çıkışlar

String

Bu cmdlet şifrelenmemiş iletiyi döndürür.

İlişkili Bağlantılar

• Sağlayıcılar_Hakkında
• Get-CmsMessage (Cms mesajını al)
• CmsMesajı Koru