Aracılığıyla paylaş

Windows kapsayıcıları ile IoT Edge için PowerShell betikleri

Şunlar için geçerlidir:yes iconevet simgesi IoT Edge 1.1

Önemli

IoT Edge 1.1 destek sonu tarihi 13 Aralık 2022. Bu ürünün, hizmetin, teknolojinin veya API’nin nasıl desteklendiği hakkında bilgi edinmek için Microsoft Ürün Yaşam Döngüsü’ne göz atın. IoT Edge'in en son sürümüne güncelleme hakkında daha fazla bilgi için IoT Edge'i Güncelleştirin bölümüne bakın.

Windows cihazlarında IoT Edge'i yükleyen, güncelleştiren veya kaldıran PowerShell betiklerini anlayın.

Bu makalede açıklanan komutlar, her IoT Edge sürümüyle birlikte yayımlanan dosyadan IoTEdgeSecurityDaemon.ps1 alınıyor. Betiğin en son sürümü aka.ms/iotedge-win her zaman kullanılabilir.

En son betik sürümüne erişmek için cmdlet'ini kullanarak Invoke-WebRequest komutlardan herhangi birini çalıştırabilirsiniz. Örneğin:

. {Invoke-WebRequest -useb https://aka.ms/iotedge-win} | Invoke-Expression; `
Deploy-IoTEdge

Komutları çalıştırmak için bu betiği veya belirli bir sürümdeki betiğin bir sürümünü de indirebilirsiniz. Örneğin:

. <path>\IoTEdgeSecurityDaemon.ps1
Deploy-IoTEdge

Sağlanan betik, güvenliği artırmak için imzalanmıştır. Betiği cihazınıza indirip aşağıdaki PowerShell komutunu çalıştırarak imzayı doğrulayabilirsiniz:

Get-AuthenticodeSignature "C:\<path>\IotEdgeSecurityDaemon.ps1"

İmza doğrulandıysa çıkış durumu Geçerli olur.

Deploy-IoTEdge

Deploy-IoTEdge komutu IoT Edge Güvenlik Daemon'unu ve bağımlılıklarını indirir ve dağıtır. Dağıtım komutu, bu ortak parametreleri ve diğer parametreleri kabul eder. Tam liste için komutunu Get-Help Deploy-IoTEdge -fullkullanın.

Parametre Kabul edilen değerler Yorumlar
Kapsayıcılar Windows veya Linux Hiçbir kapsayıcı işletim sistemi belirtilmezse, Windows varsayılan değerdir.

Windows kapsayıcıları için IoT Edge, yüklemede yer alan Moby kapsayıcı altyapısını kullanır. Linux kapsayıcıları için, yüklemeyi başlatmadan önce bir kapsayıcı altyapısı yüklemeniz gerekir.
Proxy Proxy URL'si Cihazınızın İnternet'e ulaşmak için bir ara sunucudan geçmesi gerekiyorsa bu parametreyi ekleyin. Daha fazla bilgi için bkz . Bir IoT Edge cihazını ara sunucu üzerinden iletişim kuracak şekilde yapılandırma.
OfflineInstallationPath Dizin yolu Bu parametre dahil edilirse yükleyici, yükleme için gereken IoT Edge kabini ve VC Çalışma Zamanı MSI dosyaları için listelenen dizini denetler. Dizinde bulunmayan tüm dosyalar indirilir. Her iki dosya da dizindeyse IoT Edge'i İnternet bağlantısı olmadan yükleyebilirsiniz. Bu parametreyi belirli bir sürümü kullanmak için de kullanabilirsiniz.
InvokeWebRequestParameters Parametrelerin ve değerlerin karma tablosu Yükleme sırasında birkaç web isteği yapılır. Bu web isteklerinin parametrelerini ayarlamak için bu alanı kullanın. Bu parametre, proxy sunucuları için kimlik bilgilerini yapılandırmak için kullanışlıdır. Daha fazla bilgi için bkz . Bir IoT Edge cihazını ara sunucu üzerinden iletişim kuracak şekilde yapılandırma.
RestartIfNeeded yok Bu bayrak, gerekirse dağıtım betiğinin istenmeden makineyi yeniden başlatmasını sağlar.

Initialize-IoTEdge

Initialize-IoTEdge komutu IoT Edge'i cihaz bağlantı dizeniz ve işlem ayrıntılarınızla yapılandırıyor. Bu komut tarafından oluşturulan bilgilerin çoğu daha sonra iotedge\config.yaml dosyasında depolanır. Başlatma komutu, bu ortak parametreleri ve diğer parametreleri kabul eder. Tam liste için komutunu Get-Help Initialize-IoTEdge -fullkullanın.

Parametre Kabul edilen değerler Yorumlar
ManualConnectionString Hiç kimse Anahtar parametresi. varsayılan değeri. Sağlama türü belirtilmezse, bağlantı dizesiyle el ile sağlama varsayılan değerdir.

Cihazı el ile sağlamak için bir cihaz bağlantı dizesi sağlayacağınızı bildirir.
ManualX509 Hiç kimse Anahtar parametresi. Sağlama türü belirtilmezse, bağlantı dizesiyle el ile sağlama varsayılan değerdir.

Cihazı el ile sağlamak için bir kimlik sertifikası ve özel anahtar sağlayacağınızı bildirir.
DpsTpm Hiç kimse Anahtar parametresi. Sağlama türü belirtilmezse, bağlantı dizesiyle el ile sağlama varsayılan değerdir.

DPS aracılığıyla sağlanacak bir Cihaz Sağlama Hizmeti (DPS) kapsam kimliği ve cihazınızın Kayıt Kimliği sağlayacağınızı bildirir.
DpsSymmetricKey Hiç kimse Anahtar parametresi. Sağlama türü belirtilmezse, bağlantı dizesiyle el ile sağlama varsayılan değerdir.

Bir Cihaz Sağlama Hizmeti (DPS) kapsam kimliği ve DPS aracılığıyla sağlanacak cihazınızın Kayıt Kimliği ile kanıtlama için simetrik anahtar sağlayacağınızı bildirir.
DpsX509 Hiç kimse Anahtar parametresi. Sağlama türü belirtilmezse, bağlantı dizesiyle el ile sağlama varsayılan değerdir.

Bir Cihaz Sağlama Hizmeti (DPS) kapsam kimliği ve DPS aracılığıyla sağlanacak cihazınızın Kayıt Kimliği ile kanıtlama için X.509 kimlik sertifikası ve özel anahtar sağlayacağınızı bildirir.
DeviceConnectionString IoT Hub'a kayıtlı bir IoT Edge cihazından tek tırnak içine alınan bağlantı dizesi Bağlantı dizesiyle el ile sağlama için gereklidir. Betik parametrelerinde bir bağlantı dizesi sağlamazsanız, sizden bir bağlantı dizesi istenir.
IotHubHostName Bir cihazın bağlandığını IoT hub'ının ana bilgisayar adı. X.509 sertifikalarıyla el ile sağlama için gereklidir. {hub name}.azure-devices.net biçimini alır.
deviceid IoT Hub'da kayıtlı bir cihaz kimliğinden alınan cihaz kimliği. X.509 sertifikalarıyla el ile sağlama için gereklidir.
ScopeId IoT Hub'ınızla ilişkilendirilmiş bir Cihaz Sağlama Hizmeti örneğinden alınan kapsam kimliği. DPS sağlama için gereklidir. Betik parametrelerinde kapsam kimliği sağlamazsanız sizden bir kapsam kimliği istenir.
RegistrationId Cihazınız tarafından oluşturulan kayıt kimliği TPM veya simetrik anahtar kanıtlaması kullanılıyorsa DPS sağlama için gereklidir. X.509 sertifika kanıtlaması kullanılıyorsa isteğe bağlı.
X509IdentityCertificate Cihazdaki X.509 cihaz kimlik sertifikasının URI yolu. X.509 sertifika kanıtlama kullanılıyorsa el ile veya DPS sağlama için gereklidir.
X509IdentityPrivateKey Cihazdaki X.509 cihaz kimliği sertifika anahtarının URI yolu. X.509 sertifika kanıtlama kullanılıyorsa el ile veya DPS sağlama için gereklidir.
SymmetricKey DPS kullanırken IoT Edge cihaz kimliğini sağlamak için kullanılan simetrik anahtar Simetrik anahtar kanıtlaması kullanılıyorsa DPS sağlama için gereklidir.
Kapsayıcılar Windows veya Linux Hiçbir kapsayıcı işletim sistemi belirtilmezse, Windows varsayılan değerdir.

Windows kapsayıcıları için IoT Edge, yüklemede yer alan Moby kapsayıcı altyapısını kullanır. Linux kapsayıcıları için, yüklemeyi başlatmadan önce bir kapsayıcı altyapısı yüklemeniz gerekir.
DeviceCACertificate Cihazdaki X.509 cihaz CA sertifikasının URI yolu. Dosyada C:\ProgramData\iotedge\config.yaml da yapılandırılabilir. Daha fazla bilgi için bkz. IoT Edge cihazında sertifikaları yönetme.
DeviceCAPrivateKey Cihazdaki X.509 cihaz CA özel anahtarının URI yolu. Dosyada C:\ProgramData\iotedge\config.yaml da yapılandırılabilir. Daha fazla bilgi için bkz. IoT Edge cihazında sertifikaları yönetme.
InvokeWebRequestParameters Parametrelerin ve değerlerin karma tablosu Yükleme sırasında birkaç web isteği yapılır. Bu web isteklerinin parametrelerini ayarlamak için bu alanı kullanın. Bu parametre, proxy sunucuları için kimlik bilgilerini yapılandırmak için kullanışlıdır. Daha fazla bilgi için bkz . Bir IoT Edge cihazını ara sunucu üzerinden iletişim kuracak şekilde yapılandırma.
AgentImage IoT Edge aracı görüntüsü URI'si Yeni bir IoT Edge yüklemesi varsayılan olarak IoT Edge aracı görüntüsü için en son sıralı etiketi kullanır. Görüntü sürümü için belirli bir etiket ayarlamak veya kendi aracı görüntünüzü sağlamak için bu parametreyi kullanın. Daha fazla bilgi için bkz. IoT Edge etiketlerini anlama.
Kullanıcı adı Kapsayıcı kayıt defteri kullanıcı adı Bu parametreyi yalnızca -AgentImage parametresini özel kayıt defterindeki bir kapsayıcıya ayarlarsanız kullanın. Kayıt defterine erişimi olan bir kullanıcı adı sağlayın.
Parola Güvenli parola dizesi Bu parametreyi yalnızca -AgentImage parametresini özel kayıt defterindeki bir kapsayıcıya ayarlarsanız kullanın. Kayıt defterine erişmek için parolayı belirtin.

Update-IoTEdge

Parametre Kabul edilen değerler Yorumlar
Kapsayıcılar Windows veya Linux Herhangi bir kapsayıcı işletim sistemi belirtilmezse, Windows varsayılan değerdir. Windows kapsayıcıları için, yüklemeye bir kapsayıcı altyapısı eklenir. Linux kapsayıcıları için, yüklemeyi başlatmadan önce bir kapsayıcı altyapısı yüklemeniz gerekir.
Proxy Proxy URL'si Cihazınızın İnternet'e ulaşmak için bir ara sunucudan geçmesi gerekiyorsa bu parametreyi ekleyin. Daha fazla bilgi için bkz . Bir IoT Edge cihazını ara sunucu üzerinden iletişim kuracak şekilde yapılandırma.
InvokeWebRequestParameters Parametrelerin ve değerlerin karma tablosu Yükleme sırasında birkaç web isteği yapılır. Bu web isteklerinin parametrelerini ayarlamak için bu alanı kullanın. Bu parametre, proxy sunucuları için kimlik bilgilerini yapılandırmak için kullanışlıdır. Daha fazla bilgi için bkz . Bir IoT Edge cihazını ara sunucu üzerinden iletişim kuracak şekilde yapılandırma.
OfflineInstallationPath Dizin yolu Bu parametre dahil edilirse yükleyici, yükleme için gereken IoT Edge kabini ve VC Çalışma Zamanı MSI dosyaları için listelenen dizini denetler. Dizinde bulunmayan tüm dosyalar indirilir. Her iki dosya da dizindeyse IoT Edge'i İnternet bağlantısı olmadan yükleyebilirsiniz. Bu parametreyi belirli bir sürümü kullanmak için de kullanabilirsiniz.
RestartIfNeeded yok Bu bayrak, gerekirse dağıtım betiğinin istenmeden makineyi yeniden başlatmasını sağlar.

Uninstall-IoTEdge

Parametre Kabul edilen değerler Yorumlar
Zorla yok Bu bayrak, önceki kaldırma girişiminin başarısız olması durumunda kaldırmayı zorlar.
RestartIfNeeded yok Bu bayrak, gerekirse kaldırma betiğinin istenmeden makineyi yeniden başlatmasını sağlar.

Sonraki Adımlar

Aşağıdaki makalede bu komutları kullanmayı öğrenin:

  • Last updated on